UsbPm_RetrieveConnectorState-Funktion (usbpmapi.h)
Ruft den aktuellen Status eines Connectors ab. Im Gegensatz zu Connectoreigenschaften sind Statusinformationen 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_Registerempfangen hat.
[In] ConnectorHandle
Das Connectorhandle, das vom Richtlinien-Manager bereitgestellt wird, wenn er die Implementierung des treibers von EVT_USBPM_EVENT_CALLBACKaufruft. Das Handle wird im EventData.ConnectorStateChange.ConnectorHandle Member des Params--Werts festgelegt.
[Out] ConnectorState
Ein Zeiger auf eine vom Treiber bereitgestellte USBPM_CONNECTOR_STATE Struktur, die den Verbindungszustand empfängt. Initialisieren Sie die Struktur, indem Sie USBPM_CONNECTOR_STATE_INITaufrufen.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Gibt andernfalls einen geeigneten NTSTATUS- Wert zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1809 |
| Minimale KMDF-Version | 1.27 |
| Mindest-UMDF-Version | 2.27 |
| Header- | usbpmapi.h |
| Library | UsbPmApi.lib |
| IRQL- | PASSIVE_LEVEL |