EVT_UCX_USBDEVICE_ENABLE funzione di callback (ucxusbdevice.h)

Articolo
02/26/2024

Implementazione del driver client che UCX chiama al programma informazioni sul dispositivo e sul relativo endpoint di controllo predefinito nel controller.

Sintassi

EVT_UCX_USBDEVICE_ENABLE EvtUcxUsbdeviceEnable;

void EvtUcxUsbdeviceEnable(
  [in] UCXCONTROLLER UcxController,
  [in] WDFREQUEST Request
)
{...}

Parametri

[in] UcxController

Handle al controller UCX ricevuto dal driver client in una chiamata precedente al metodo UcxControllerCreate .

[in] Request

Struttura di tipo USBDEVICE_ENABLE.

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 .

Per passare il dispositivo allo stato desiderato, il driver del controller host comunica con l'hardware per completare la richiesta.

In questa funzione di callback, il driver client prepara il controller ad accettare e pianificare i trasferimenti nell'endpoint di controllo predefinito per il dispositivo USB.

Al termine del driver, completa WDFREQUEST.

Il driver client restituisce lo stato di completamento nella richiesta. Il driver può completare in modo asincrono WDFREQUEST.

Esempio

VOID
UsbDevice_EvtUcxUsbDeviceEnable(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)
    
{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceEnable");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
    usbDeviceEnable = (PUSBDEVICE_ENABLE)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

Condividi tramite