EVT_UCX_ENDPOINT_PURGE回呼函式 (ucxendpoint.h)

用戶端驅動程序的實作會完成端點上所有未完成的 I/O 要求。

語法

EVT_UCX_ENDPOINT_PURGE EvtUcxEndpointPurge;

void EvtUcxEndpointPurge(
  [in] UCXCONTROLLER UcxController,
  [in] UCXENDPOINT UcxEndpoint
)
{...}

參數

[in] UcxController

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

[in] UcxEndpoint

代表端點之 UCXENDPOINT 物件的句柄。

傳回值

無

備註

UCX 用戶端驅動程式會藉由呼叫 UcxEndpointCreate 方法，向 USB 主機控制器擴充功能註冊此回呼函式， (UCX) 。

一般而言，此函式會呼叫 WdfIoQueuePurge。

在UCX呼叫此函式之後，客戶端驅動程式會失敗的後續I/O要求，直到UCX呼叫客戶端驅動程式 的EVT_UCX_ENDPOINT_START 回呼函式為止。

範例

VOID
Endpoint_UcxEvtEndpointPurge(
    UCXCONTROLLER   UcxController,
    UCXENDPOINT     UcxEndpoint
    )
{
            WdfIoQueuePurge(endpointContext->WdfQueue,
                            Endpoint_WdfEvtPurgeComplete,
                            UcxEndpoint);
}

規格需求

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

另請參閱

• WdfIoQueuePurge