Partager via


fonction UsbPm_RetrieveConnectorState (usbpmapi.h)

Récupère l’état actuel d’un connecteur. Contrairement aux propriétés du connecteur, les informations d’état sont dynamiques, ce qui peut changer au moment de l’exécution.

Syntaxe

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

Paramètres

[In] ClientHandle

Handle que le pilote client a reçu lors d’un appel précédent à UsbPm_Register.

[In] ConnectorHandle

Handle de connecteur fourni par Policy Manager lorsqu’il appelle l’implémentation du pilote de EVT_USBPM_EVENT_CALLBACK. Le handle est défini dans le membre EventData.ConnectorStateChange.ConnectorHandle de la valeur Params .

[Out] ConnectorState

Pointeur vers une structure de USBPM_CONNECTOR_STATE fournie par le pilote qui reçoit l’état du connecteur. Initialisez la structure en appelant USBPM_CONNECTOR_STATE_INIT.

Valeur retournée

Retourne STATUS_SUCCESS si l’opération réussit. Sinon, retourne une valeur NTSTATUS appropriée.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1809
Version KMDF minimale 1,27 %
Version UMDF minimale 2,27
En-tête usbpmapi.h
Bibliothèque UsbPmApi.lib
IRQL PASSIVE_LEVEL

Voir aussi

UsbPm_Register

EVT_USBPM_EVENT_CALLBACK