擷取連接器的屬性。 屬性是靜態的,在連接器生命週期期間不會變更。
語法
NTSTATUS UsbPm_RetrieveConnectorProperties(
[In] USBPM_CLIENT ClientHandle,
[In] USBPM_CONNECTOR ConnectorHandle,
[Out] PUSBPM_CONNECTOR_PROPERTIES ConnectorProperties
);
參數
[In] ClientHandle
用戶端驅動程式在先前呼叫中收到的句柄,UsbPm_Register。
[In] ConnectorHandle
當連接器呼叫驅動程序實作 EVT_USBPM_EVENT_CALLBACK時,原則管理員所提供的連接器句柄。 句柄會在 EventData.ConnectorStateChange.ConnectorHandle 參數 值的成員中設定。
[Out] ConnectorProperties
驅動程式提供的 USBPM_CONNECTOR_PROPERTIES 結構的指標,可接收連接器屬性。 呼叫 USBPM_CONNECTOR_PROPERTIES_INIT來初始化 結構。
傳回值
如果作業成功,則傳回STATUS_SUCCESS。 否則,會傳回適當的 NTSTATUS 值。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 10 版本 1809 |
| 最低 KMDF 版本 | 1.27 |
| 最低 UMDF 版本 | 2.27 |
| 標頭 | usbpmapi.h |
| 連結庫 | UsbPmApi.lib |
| IRQL | PASSIVE_LEVEL |