IMMDevice::GetState method (mmdeviceapi.h)
The GetState method retrieves the current device state.
Syntax
HRESULT GetState(
[out] DWORD *pdwState
);
Parameters
[out] pdwState
Pointer to a DWORD variable into which the method writes the current state of the device. The device-state value is one of the following DEVICE_STATE_XXX constants:
DEVICE_STATE_ACTIVE
DEVICE_STATE_DISABLED
DEVICE_STATE_NOTPRESENT
DEVICE_STATE_UNPLUGGED
Return value
If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.
| Return code | Description |
|---|---|
|
Parameter pdwState is NULL. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | mmdeviceapi.h |