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