EVT_UCX_USBDEVICE_DISABLE funzione di callback (ucxusbdevice.h)
Implementazione del driver client che UCX chiama per rilasciare le risorse controller associate al dispositivo e al relativo endpoint predefinito.
Sintassi
EVT_UCX_USBDEVICE_DISABLE EvtUcxUsbdeviceDisable;
void EvtUcxUsbdeviceDisable(
[in] UCXCONTROLLER UcxController,
[in] WDFREQUEST Request
)
{...}
Parametri
[in] UcxController
Handle per il controller UCX ricevuto dal driver client in una chiamata precedente al metodo UcxControllerCreate .
[in] Request
Struttura di tipo USBDEVICE_DISABLE.
Valore restituito
nessuno
Osservazioni
Il driver client UCX registra questa funzione di callback con l'estensione del controller host USB (UCX) chiamando il metodo UcxUsbDeviceCreate .
Quando il driver client ha rilasciato risorse controller, completa WDFREQUEST. Al termine, l'unica funzione di callback che UCX chiama a fare riferimento a questo dispositivo USB è EVT_UCX_USBDEVICE_ENABLE.
Mentre il dispositivo è disabilitato, UCX non pianifica i trasferimenti.
Per eseguire la transizione del dispositivo allo stato desiderato, il driver del controller host comunica con l'hardware per completare la richiesta.
Il driver client restituisce lo stato di completamento in Richiesta. Il driver può completare WDFREQUEST in modo asincrono.
Esempio
VOID
UsbDevice_EvtUcxUsbDeviceDisable(
UCXCONTROLLER UcxController,
WDFREQUEST Request
)
{
UNREFERENCED_PARAMETER(UcxController);
DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceDisable");
WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
usbDeviceDisable = (PUSBDEVICE_DISABLE)wdfRequestParams.Parameters.Others.Arg1;
...
WdfRequestComplete(Request, STATUS_SUCCESS);
}
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Versione KMDF minima | 1,0 |
| Versione UMDF minima | 2,0 |
| Intestazione | ucxusbdevice.h (include Ucxclass.h) |
| IRQL | DISPATCH_LEVEL |