UsbPm_RetrieveConnectorState-Funktion (usbpmapi.h)

Ruft den aktuellen Status eines Connectors ab. Im Gegensatz zu Connectoreigenschaften sind Zustandsinformationen dynamisch, die sich zur Laufzeit ändern können.

Syntax

NTSTATUS UsbPm_RetrieveConnectorState(
  [In]  USBPM_CLIENT           ClientHandle,
  [In]  USBPM_CONNECTOR        ConnectorHandle,
  [Out] PUSBPM_CONNECTOR_STATE ConnectorState
);

Parameter

[In] ClientHandle

Das Handle, das der Clienttreiber in einem vorherigen Aufruf von UsbPm_Register erhalten hat.

[In] ConnectorHandle

Das Connectorhandle, das vom Policy Manager bereitgestellt wird, wenn er die Implementierung von EVT_USBPM_EVENT_CALLBACK des Treibers aufruft. Das Handle wird im Element EventData.ConnectorStateChange.ConnectorHandle des Params-Werts festgelegt.

[Out] ConnectorState

Ein Zeiger auf eine vom Treiber bereitgestellte USBPM_CONNECTOR_STATE-Struktur , die den Connectorstatus empfängt. Initialisieren Sie die Struktur, indem Sie USBPM_CONNECTOR_STATE_INIT aufrufen.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Wert zurückgegeben.

Anforderungen

Weitere Informationen

UsbPm_Register

EVT_USBPM_EVENT_CALLBACK