DiChangeState
RETERR DiChangeState(LPDEVICE_INFO lpdi, DWORD dwStateChange, DWORD dwFlags, LPARAM lParam)
This API is used to change the state of an installed device. It is the default handler for the DIF_PROPERTYCHANGE class installer message.
- This function returns OK if that are files that need to be copied. ERR_DI_NOFILECOPY will be returned if no files need to be copied.
- lpdi
- Device Info for device who's properties are being changed.
- dwStateChange
- Flag indicating which state is being changed.
| DICS_ENABLE |
The device is being enabled. |
| DICS_DISABLE |
The device is being disabled. |
| DICS_PROPCHANGE |
The properties of the device have changed, i.e. it is getting a new resource assignement. |
| DICS_START |
The device is being started. If the device also disabled it will be enabled as well. |
| DICS_STOP |
The device is being stoped. |
- dwFlags
- Flags specific to the action specified by dwChangeState.
| DICS_FLAG_GLOBAL |
The action should be applied globally to all configurations. |
| DICS_FLAG_CONFIGSPECIFIC |
The action should be applied ony to the configuration specified by lParam. |
- lParam
- If dwFlags has the DICS_FLAG_CONFIGSPECIFIC bit set then this param contains the configuration number which the changes should be applied to. Specifying 0 indicates that the current config should be used.