UsbPm_RetrieveHubConnectorHandles function (usbpmapi.h)

Retrieves connector handles for all connectors of a hub.

Syntax

NTSTATUS UsbPm_RetrieveHubConnectorHandles(
  [In]  USBPM_CLIENT                 ClientHandle,
  [In]  USBPM_HUB                    HubHandle,
  [Out] PUSBPM_HUB_CONNECTOR_HANDLES HubConnectorHandles
);

Parameters

[In] ClientHandle

The handle that the client driver received in a previous call to UsbPm_Register.

[In] HubHandle

The handle to the hub.

[Out] HubConnectorHandles

A pointer to a USBPM_HUB_CONNECTOR_HANDLES structures that contains the connector handles. Initialize this structure by calling USBPM_HUB_CONNECTOR_HANDLES_INIT. The array is allocated by the Policy Manager is valid during the life time of the hub. The client driver must not change the array or release the array after use.

Return value

This function returns NTSTATUS.

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