Edit

UsbPm_RetrieveHubProperties function (usbpmapi.h)

  • Article

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

See also

UsbPm_Register

EVT_USBPM_EVENT_CALLBACK