UsbPm_RetrieveHubProperties function (usbpmapi.h)
Retrieves the properties of a hub. The properties are static, which do not change during the lifecycle of a hub.
Syntax
NTSTATUS UsbPm_RetrieveHubProperties(
[In] USBPM_CLIENT ClientHandle,
[In] USBPM_HUB HubHandle,
[Out] PUSBPM_HUB_PROPERTIES HubProperties
);
Parameters
[In] ClientHandle
The handle that the client driver received in a previous call to UsbPm_Register.
[In] HubHandle
The hub handle provided by Policy Manager when it calls the driver's implementation of EVT_USBPM_EVENT_CALLBACK. The handle is set in the EventData.HubArrivalRemoval.HubHandle member of the Params value.
[Out] HubProperties
A pointer to a driver-provided USBPM_HUB_PROPERTIES structure that receives the hub properties. Initialize the structure by calling USBPM_HUB_PROPERTIES_INIT.
Return value
Returns STATUS_SUCCESS if the operation succeeds. Otherwise, returns an appropriate NTSTATUS value.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10, version 1809 |
| Minimum KMDF version | 1.27 |
| Minimum UMDF version | 2.27 |
| Header | usbpmapi.h |
| Library | UsbPmApi.lib |
| IRQL | PASSIVE_LEVEL |