EVT_UCX_ROOTHUB_GET_INFO funzione di callback (ucxroothub.h)

Articolo
02/29/2024

Implementazione del driver client che ucx chiama quando riceve una richiesta di informazioni sull'hub radice.

Sintassi

EVT_UCX_ROOTHUB_GET_INFO EvtUcxRoothubGetInfo;

void EvtUcxRoothubGetInfo(
  [in] UCXROOTHUB UcxRootHub,
  [in] WDFREQUEST Request
)
{...}

Parametri

[in] UcxRootHub

Handle per un oggetto UCX che rappresenta l'hub radice.

[in] Request

Struttura di tipo ROOTHUB_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 UcxRootHubCreate .

La struttura _ROOTHUB_INFO contiene il numero di porte USB 2.0 e USB 3.0 supportate dall'hub radice.

Dopo che UCX chiama la funzione EVT_UCX_ROOTHUB_GET_INFO , il numero di porte esposte dall'hub radice rimane invariato. Si noti che si tratta di porte virtuali, non di porte fisiche. Ogni connettore USB fisico è rappresentato da una o più porte di velocità diverse nell'hub radice.

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

Esempio

VOID
RootHub_EvtRootHubGetInfo(
    UCXROOTHUB         UcxRootHub,
    WDFREQUEST         Request
)
/*++

    For sample demonstration purposes, this function returns statically
    defined information for the root hub.

--*/
{
    PUCX_ROOTHUB_CONTEXT    ucxRootHubContext;
    WDF_REQUEST_PARAMETERS  wdfRequestParams;
    PROOTHUB_INFO           rootHubInfo;
    NTSTATUS                status;

    ucxRootHubContext = GetUcxRootHubContext(UcxRootHub);

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(Request, &wdfRequestParams);

    rootHubInfo = (PROOTHUB_INFO)wdfRequestParams.Parameters.Others.Arg1;

    if (rootHubInfo->Size < sizeof(ROOTHUB_INFO)) {
        DbgTrace(TL_ERROR, RootHub, "Invalid ROOTHUB_INFO Size %d", rootHubInfo->Size);
        status = STATUS_INVALID_PARAMETER;
        goto RootHub_EvtRootHubGetInfo;
    }

    rootHubInfo->ControllerType = ControllerTypeSoftXhci;
    rootHubInfo->NumberOf20Ports = ucxRootHubContext->NumberOf20Ports;
    rootHubInfo->NumberOf30Ports = ucxRootHubContext->NumberOf30Ports;
    rootHubInfo->MaxU1ExitLatency = ucxRootHubContext->U1DeviceExitLatency;
    rootHubInfo->MaxU2ExitLatency = ucxRootHubContext->U2DeviceExitLatency;

    DbgTrace(TL_INFO, RootHub, "RootHub_UcxEvtGetInfo NumberOf20Ports %d NumberOf30Ports %d", rootHubInfo->NumberOf20Ports, rootHubInfo->NumberOf30Ports);

    status = STATUS_SUCCESS;

RootHub_EvtRootHubGetInfo:

    WdfRequestComplete(Request, status);
}

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Versione KMDF minima	1,0
Versione UMDF minima	2,0
Intestazione	ucxroothub.h (include Ucxclass.h)
IRQL	DISPATCH_LEVEL

Vedi anche

_ROOTHUB_INFO

Condividi tramite