EVT_UDECX_USB_DEVICE_D0_ENTRY fonction de rappel (udecxusbdevice.h)

  • Article

L’extension de classe d’émulation de périphérique USB (UdeCx) appelle cette fonction de rappel lorsqu’elle obtient une demande de sortie de l’état de fonctionnement du périphérique USB virtuel.

Syntaxe

EVT_UDECX_USB_DEVICE_D0_ENTRY EvtUdecxUsbDeviceD0Entry;

NTSTATUS EvtUdecxUsbDeviceD0Entry(
  [in] WDFDEVICE UdecxWdfDevice,
  [in] UDECXUSBDEVICE UdecxUsbDevice
)
{...}

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.

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 doit effectuer les étapes pour entrer en état de fonctionnement.

La demande d’alimentation peut être effectuée de manière asynchrone en retournant STATUS_PENDING, puis en l’effectuant ultérieurement en appelant 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

Voir aussi

Architecture : Émulation de périphérique USB (UDE)

EVT_UDECX_USB_DEVICE_D0_EXIT

UdecxUsbDeviceLinkPowerExitComplete

UdecxUsbDeviceSignalWake

Écrire un pilote client UDE