UsbPm_RetrieveConnectorState函式 （usbpmapi.h）

擷取連接器的目前狀態。 不同於連接器屬性，狀態資訊是動態的，可在運行時間變更。

語法

NTSTATUS UsbPm_RetrieveConnectorState(
  [In]  USBPM_CLIENT           ClientHandle,
  [In]  USBPM_CONNECTOR        ConnectorHandle,
  [Out] PUSBPM_CONNECTOR_STATE ConnectorState
);

參數

[In] ClientHandle

用戶端驅動程式在先前呼叫中收到的句柄，UsbPm_Register。

[In] ConnectorHandle

當連接器呼叫驅動程序實作 EVT_USBPM_EVENT_CALLBACK時，原則管理員所提供的連接器句柄。 句柄會在 EventData.ConnectorStateChange.ConnectorHandle 參數 值的成員中設定。

[Out] ConnectorState

驅動程式提供的 USBPM_CONNECTOR_STATE 結構的指標，該結構會接收連接器狀態。 呼叫 USBPM_CONNECTOR_STATE_INIT來初始化 結構。

傳回值

如果作業成功，則傳回STATUS_SUCCESS。 否則，會傳回適當的 NTSTATUS 值。

要求

另請參閱

UsbPm_Register

EVT_USBPM_EVENT_CALLBACK