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, viene completato WDFREQUEST. Al termine, l'unica funzione di callback che UCX chiama facendo riferimento a questo dispositivo USB è EVT_UCX_USBDEVICE_ENABLE.
Anche se 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 Request. Il driver può completare WDFREQUEST in modo asincrono.
Esempi
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);
}
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 2.0 |
| intestazione | ucxusbdevice.h (include Ucxclass.h) |
| IRQL | DISPATCH_LEVEL |