UsbPm_RetrieveConnectorProperties function (usbpmapi.h)
Retrieves the properties of a connector. The properties are static, which do not change during the lifecycle of a connector.
Syntax
NTSTATUS UsbPm_RetrieveConnectorProperties(
[In] USBPM_CLIENT ClientHandle,
[In] USBPM_CONNECTOR ConnectorHandle,
[Out] PUSBPM_CONNECTOR_PROPERTIES ConnectorProperties
);
Parameters
[In] ClientHandle
The handle that the client driver received in a previous call to UsbPm_Register.
[In] ConnectorHandle
The connector handle provided by Policy Manager when it calls the driver's implementation of EVT_USBPM_EVENT_CALLBACK. The handle is set in the EventData.ConnectorStateChange.ConnectorHandle member of the Params value.
[Out] ConnectorProperties
A pointer to a driver-provided USBPM_CONNECTOR_PROPERTIES structure that receives the connector properties. Initialize the structure by calling USBPM_CONNECTOR_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 |