EVT_UCX_USBDEVICE_HUB_INFO funzione di callback (ucxusbdevice.h)

Articolo
02/07/2025

Implementazione del driver client che UCX chiama per recuperare le proprietà dell'hub.

Sintassi

EVT_UCX_USBDEVICE_HUB_INFO EvtUcxUsbdeviceHubInfo;

void EvtUcxUsbdeviceHubInfo(
  [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

Contiene la struttura USBDEVICE_HUB_INFO.

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.

Se il dispositivo USB non è un hub, non fornire questo callback.

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

Esempi

VOID
UsbDevice_EvtUcxUsbDeviceHubInfo(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)

{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceHubInfo");

    //
    // Retrieve the USBDEVICE_HUB_INFO pointer from the
    // IOCTL_INTERNAL_USB_USBDEVICE_HUB_INFO WdfRequest.
    //
    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);

    hubInfo = (PUSBDEVICE_HUB_INFO)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

UCX_USBDEVICE_EVENT_CALLBACKS

UCX_USBDEVICE_EVENT_CALLBACKS_INIT

USBDEVICE_HUB_INFO

UcxUsbDeviceCreare

Condividi tramite