EVT_UCX_USBDEVICE_DISABLE funzione di callback (ucxusbdevice.h)

  • Articolo

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

Vedi anche

UcxUsbDeviceCreate