EVT_UCX_DEFAULT_ENDPOINT_UPDATE回呼函式 (ucxendpoint.h)

用戶端驅動程序的實作,UCX 會以預設端點的相關信息呼叫。

語法

EVT_UCX_DEFAULT_ENDPOINT_UPDATE EvtUcxDefaultEndpointUpdate;

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

參數

[in] UcxController

用戶端驅動程式在先前呼叫 UcxControllerCreate 方法時收到的UCX控制器句柄。

[in] Request

包含要更新之預設端點句柄 的DEFAULT_ENDPOINT_UPDATE 結構。

傳回值

備註

UCX 用戶端驅動程式會藉由呼叫 UcxEndpointCreate 方法,向 USB 主機控制器擴充功能 (UCX) 註冊其EVT_UCX_DEFAULT_ENDPOINT_UPDATE實作。

UCX 通常會呼叫此例程,以更新預設端點的最大封包大小。 用戶端驅動程式會在 WDFREQUEST 中傳回完成狀態,它可以以異步方式完成。

範例

VOID
Endpoint_EvtUcxDefaultEndpointUpdate(
    UCXCONTROLLER   UcxController,
    WDFREQUEST      Request
)

{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, Endpoint, "Endpoint_EvtUcxDefaultEndpointUpdate");

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

    defaultEndpointUpdate = (PDEFAULT_ENDPOINT_UPDATE)wdfRequestParams.Parameters.Others.Arg1;
    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}

規格需求

需求
目標平台 Windows
最小 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 ucxendpoint.h (包括 Ucxclass.h、Ucxendpoint.h)
IRQL DISPATCH_LEVEL

另請參閱

UCX_DEFAULT_ENDPOINT_EVENT_CALLBACKS_INIT

UcxDefaultEndpointInitSetEventCallbacks