EVT_UDECX_USB_DEVICE_D0_EXIT fonction de rappel (udecxusbdevice.h)

Article
02/26/2024

L’extension de classe d’émulation de périphérique USB (UdeCx) appelle cette fonction de rappel lorsqu’elle reçoit une demande d’envoi du périphérique USB virtuel à un état d’alimentation faible.

Syntaxe

EVT_UDECX_USB_DEVICE_D0_EXIT EvtUdecxUsbDeviceD0Exit;

NTSTATUS EvtUdecxUsbDeviceD0Exit(
  [in] WDFDEVICE UdecxWdfDevice,
  [in] UDECXUSBDEVICE UdecxUsbDevice,
  [in] UDECX_USB_DEVICE_WAKE_SETTING WakeSetting
)
{...}

Paramètres

[in] UdecxWdfDevice

Handle à un objet d’appareil framework qui représente le contrôleur auquel le périphérique USB est attaché. Le pilote client a initialisé cet objet dans un appel précédent à UdecxWdfDeviceAddUsbDeviceEmulation.

[in] UdecxUsbDevice

Handle vers l’objet d’appareil UDE. Le pilote client a créé cet objet dans un appel précédent à UdecxUsbDeviceCreate.

[in] WakeSetting

Valeur de type UDECX_USB_DEVICE_WAKE_SETTING qui indique la capacité de sortie de veille à distance du périphérique USB.

Valeur retournée

Si l’opération réussit, la fonction de rappel doit retourner STATUS_SUCCESS, ou une autre valeur status pour laquelle NT_SUCCESS(status) est égal à TRUE.

Remarques

Le pilote client a inscrit la fonction dans un appel précédent à UdecxUsbDeviceInitSetStateChangeCallbacks en fournissant un pointeur de fonction vers son implémentation.

Dans l’implémentation du rappel, le pilote client pour le périphérique USB est censé effectuer des étapes pour envoyer le périphérique à un état d’alimentation faible. Dans cette fonction, le pilote peut lancer sa mise en éveil à partir d’un état d’alimentation faible de liaison, d’une interruption de fonction ou des deux. Pour ce faire, le pilote d’un périphérique USB 2.0 doit appeler la méthode UdecxUsbDeviceSignalWake . Les appareils USB 3.0 doivent utiliser UdecxUsbDeviceSignalFunctionWake.

La demande d’alimentation peut être effectuée de manière asynchrone en retournant STATUS_PENDING, puis en appelant ultérieurement UdecxUsbDeviceLinkPowerExitComplete avec le code d’achèvement réel.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Serveur minimal pris en charge	Windows Server 2016
Plateforme cible	Windows
Version KMDF minimale	1.15
En-tête	udecxusbdevice.h (include Udecx.h)
IRQL	<=DISPATCH_LEVEL