EVT_UCX_ROOTHUB_GET_20PORT_INFO Rückruffunktion (ucxroothub.h)
Die Implementierung des Clienttreibers, die UCX aufruft, wenn eine Anforderung für Informationen zu USB 2.0-Ports auf dem Stammhub empfangen wird.
Syntax
EVT_UCX_ROOTHUB_GET_20PORT_INFO EvtUcxRoothubGet20PortInfo;
void EvtUcxRoothubGet20PortInfo(
[in] UCXROOTHUB UcxRootHub,
[in] WDFREQUEST Request
)
{...}
Parameter
[in] UcxRootHub
Ein Handle für ein UCX-Objekt, das den Stammhub darstellt.
[in] Request
Eine Struktur vom Typ _ROOTHUB_20PORT_INFO.
Rückgabewert
Keine
Bemerkungen
Der UCX-Clienttreiber registriert diese Rückruffunktion bei der USB-Hostcontrollererweiterung (UCX), indem die UcxRootHubCreate-Methode aufgerufen wird .
Das PortInfoArray-Array der _ROOTHUB_20PORTS_INFO-Struktur enthält eine Liste der USB 2.0-Ports, die vom Stammhub unterstützt werden.
Der Clienttreiber gibt status in Request und im USBD_STATUS im URB-Header zurück. Der Treiber kann wdFREQUEST asynchron abschließen.
Beispiele
VOID
RootHub_EvtRootHubGet20PortInfo(
UCXROOTHUB UcxRootHub,
WDFREQUEST Request
)
/*++
For sample demonstration purposes, this function returns statically
defined information for the single 2.0 port.
--*/
{
PUCX_ROOTHUB_CONTEXT ucxRootHubContext;
WDF_REQUEST_PARAMETERS wdfRequestParams;
PROOTHUB_20PORTS_INFO rootHub20PortsInfo;
NTSTATUS status;
ucxRootHubContext = GetUcxRootHubContext(UcxRootHub);
WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
WdfRequestGetParameters(Request, &wdfRequestParams);
rootHub20PortsInfo = (PROOTHUB_20PORTS_INFO)wdfRequestParams.Parameters.Others.Arg1;
if (rootHub20PortsInfo->Size < sizeof(ROOTHUB_20PORTS_INFO)) {
DbgTrace(TL_ERROR, RootHub, "Invalid ROOTHUB_20PORTS_INFO Size %d", rootHub20PortsInfo->Size);
status = STATUS_INVALID_PARAMETER;
goto RootHub_EvtRootHubGet20PortInfoEnd;
}
if (rootHub20PortsInfo->NumberOfPorts != ucxRootHubContext->NumberOf20Ports) {
DbgTrace(TL_ERROR, RootHub, "Invalid ROOTHUB_20PORTS_INFO NumberOfPorts %d", rootHub20PortsInfo->NumberOfPorts);
status = STATUS_INVALID_PARAMETER;
goto RootHub_EvtRootHubGet20PortInfoEnd;
}
if (rootHub20PortsInfo->PortInfoSize < sizeof(ROOTHUB_20PORT_INFO)) {
DbgTrace(TL_ERROR, RootHub, "Invalid ROOTHUB_20PORT_INFO Size %d", rootHub20PortsInfo->PortInfoSize);
status = STATUS_INVALID_PARAMETER;
goto RootHub_EvtRootHubGet20PortInfoEnd;
}
//
// Return static root hub 2.0 port information.
//
rootHub20PortsInfo->PortInfoArray[0]->PortNumber = ROOTHUB_20_PORT_PORT_NUMBER;
rootHub20PortsInfo->PortInfoArray[0]->Removable = TriStateTrue;
status = STATUS_SUCCESS;
DbgTrace(TL_INFO, RootHub, "RootHub_EvtRootHubGet20PortInfo");
RootHub_EvtRootHubGet20PortInfoEnd:
WdfRequestComplete(Request, status);
}
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
KMDF-Mindestversion | 1.0 |
UMDF-Mindestversion | 2.0 |
Kopfzeile | ucxroothub.h (include Ucxclass.h) |
IRQL | DISPATCH_LEVEL |