EVT_UDECX_USB_DEVICE_D0_ENTRY funzione di callback (udecxusbdevice.h)
L'estensione della classe di emulazione del dispositivo USB (UdeCx) richiama questa funzione di callback quando ottiene una richiesta per portare il dispositivo USB virtuale fuori da uno stato di alimentazione insufficiente allo stato funzionante.
Sintassi
EVT_UDECX_USB_DEVICE_D0_ENTRY EvtUdecxUsbDeviceD0Entry;
NTSTATUS EvtUdecxUsbDeviceD0Entry(
[in] WDFDEVICE UdecxWdfDevice,
[in] UDECXUSBDEVICE UdecxUsbDevice
)
{...}
Parametri
[in] UdecxWdfDevice
Handle a un oggetto dispositivo framework che rappresenta il controller a cui è collegato il dispositivo USB. Il driver client inizializza 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.
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(stato) equivale a TRUE.
Commenti
Il driver client ha registrato la funzione in una chiamata precedente a UdecxUsbDeviceInitSetStateChangeCallbacks fornendo un puntatore di funzione alla relativa implementazione.
Nell'implementazione del callback, il driver client per il dispositivo USB prevede di eseguire passaggi per immettere lo stato di lavoro.
La richiesta di alimentazione può essere completata in modo asincrono restituendo STATUS_PENDING e quindi completandola 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)