EVT_UCX_USBDEVICE_ENABLE funzione di callback (ucxusbdevice.h)

Articolo
02/07/2025

Implementazione del driver client che UCX chiama le informazioni sul programma 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 per il 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 eseguire la transizione del 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 per accettare e pianificare i trasferimenti nell'endpoint di controllo predefinito per il dispositivo USB.

Al termine del driver, viene completato WDFREQUEST.

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

Esempi

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);
}

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

Vedere anche

UcxUsbDeviceCreare

Condividi tramite