EVT_UDECX_USB_DEVICE_D0_ENTRY función de devolución de llamada (udecxusbdevice.h)

Artículo
02/27/2024

La extensión de clase de emulación de dispositivo USB (UdeCx) invoca esta función de devolución de llamada cuando obtiene una solicitud para sacar el dispositivo USB virtual de un estado de poca energía al estado de funcionamiento.

Sintaxis

EVT_UDECX_USB_DEVICE_D0_ENTRY EvtUdecxUsbDeviceD0Entry;

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

Parámetros

[in] UdecxWdfDevice

Identificador de un objeto de dispositivo de marco que representa el controlador al que está conectado el dispositivo USB. El controlador cliente inicializó este objeto en una llamada anterior a UdecxWdfDeviceAddUsbDeviceEmulation.

[in] UdecxUsbDevice

Identificador del objeto de dispositivo UDE. El controlador cliente creó este objeto en una llamada anterior a UdecxUsbDeviceCreate.

Valor devuelto

Si la operación se realiza correctamente, la función de devolución de llamada debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) es igual a TRUE.

Comentarios

El controlador cliente registró la función en una llamada anterior a UdecxUsbDeviceInitSetStateChangeCallbacks proporcionando un puntero de función a su implementación.

En la implementación de devolución de llamada, se espera que el controlador cliente del dispositivo USB realice los pasos para entrar en estado de trabajo.

La solicitud de energía se puede completar de forma asincrónica devolviendo STATUS_PENDING y, después, completándola llamando a UdecxUsbDeviceLinkPowerExitComplete con el código de finalización real.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10
Servidor mínimo compatible	Windows Server 2016
Plataforma de destino	Windows
Versión mínima de KMDF	1.15
Encabezado	udecxusbdevice.h (incluya Udecx.h)
IRQL	<=DISPATCH_LEVEL