fonction UsbPm_RetrieveConnectorState (usbpmapi.h)

Article
02/07/2025

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 reçu par le pilote client 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 USBPM_CONNECTOR_STATE fournie par le pilote qui reçoit l’état du connecteur. Initialisez la structure en appelant USBPM_CONNECTOR_STATE_INIT.

Valeur de retour

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1809
version minimale de KMDF	1.27
version minimale de UMDF	2.27
d’en-tête	usbpmapi.h
bibliothèque	UsbPmApi.lib
IRQL	PASSIVE_LEVEL

Voir aussi

UsbPm_Register

EVT_USBPM_EVENT_CALLBACK

Partager via