Share via


IMMDevice::GetState 方法 (mmdeviceapi.h)

GetState 方法會擷取目前的裝置狀態。

語法

HRESULT GetState(
  [out] DWORD *pdwState
);

參數

[out] pdwState

方法寫入裝置目前狀態的 DWORD 變數指標。 裝置狀態值是下列其中一個 DEVICE_STATE_XXX 常數:

DEVICE_STATE_ACTIVE

DEVICE_STATE_DISABLED

DEVICE_STATE_NOTPRESENT

DEVICE_STATE_UNPLUGGED

傳回值

如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括但不限於下表所示的值。

傳回碼 Description
E_POINTER
參數 pdwStateNULL

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 mmdeviceapi.h

另請參閱

IMMDevice 介面