EVT_UDECX_USB_DEVICE_D0_EXIT funzione di callback (udecxusbdevice.h)

  • Articolo

L'estensione della classe di emulazione del dispositivo USB (UdeCx) richiama questa funzione di callback quando riceve una richiesta per inviare il dispositivo USB virtuale a uno stato di alimentazione insufficiente.

Sintassi

EVT_UDECX_USB_DEVICE_D0_EXIT EvtUdecxUsbDeviceD0Exit;

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

Parametri

[in] UdecxWdfDevice

Handle per un oggetto dispositivo framework che rappresenta il controller a cui è collegato il dispositivo USB. Il driver client ha inizializzato questo oggetto in una chiamata precedente a UdecxWdfDeviceAddUsbDeviceEmulation.

[in] UdecxUsbDevice

Handle per l'oggetto dispositivo UDE. Il driver client ha creato questo oggetto in una chiamata precedente a UdecxUsbDeviceCreate.

[in] WakeSetting

Valore di tipo UDECX_USB_DEVICE_WAKE_SETTING che indica la funzionalità di riattivazione remota del dispositivo USB.

Valore restituito

Se l'operazione ha esito positivo, la funzione di callback deve restituire STATUS_SUCCESS o un altro valore di stato per cui NT_SUCCESS(status) è TRUE.

Commenti

Il driver client ha registrato la funzione in una chiamata precedente a UdecxUsbDeviceInitSetStateChangeCallbacks fornendo un puntatore a funzione alla relativa implementazione.

Nell'implementazione del callback, è previsto che il driver client per il dispositivo USB esegua i passaggi per inviare il dispositivo a uno stato a basso consumo. In questa funzione, il driver può avviare la riattivazione da uno stato di alimentazione a basso collegamento, una sospensione della funzione o entrambi. A tale scopo, il driver per un dispositivo USB 2.0 deve chiamare il metodo UdecxUsbDeviceSignalWake . I dispositivi USB 3.0 devono usare UdecxUsbDeviceSignalFunctionWake.

La richiesta di alimentazione può essere completata in modo asincrono restituendo STATUS_PENDING e quindi chiamando UdecxUsbDeviceLinkPowerExitComplete con il codice di completamento effettivo.

Requisiti

Requisito Valore
Client minimo supportato Windows 10
Server minimo supportato Windows Server 2016
Piattaforma di destinazione Windows
Versione KMDF minima 1.15
Intestazione udecxusbdevice.h (include Udecx.h)
IRQL <=DISPATCH_LEVEL

Vedi anche

Architettura: Emulazione dispositivo USB (UDE)

EVT_UDECX_USB_DEVICE_D0_ENTRY

UdecxUsbDeviceLinkPowerExitComplete

UdecxUsbDeviceSignalWake

Scrivere un driver client UDE