WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY結構 (wdfio.h)

  • 發行項

[僅適用於 KMDF]

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY結構包含驅動程式提供的資訊，架構會用來啟用I/O 佇列的保證向前進度。

語法

typedef struct _WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY {
  ULONG                                              Size;
  ULONG                                              TotalForwardProgressRequests;
  WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY            ForwardProgressReservedPolicy;
  WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS   ForwardProgressReservePolicySettings;
  PFN_WDF_IO_ALLOCATE_RESOURCES_FOR_RESERVED_REQUEST EvtIoAllocateResourcesForReservedRequest;
  PFN_WDF_IO_ALLOCATE_REQUEST_RESOURCES              EvtIoAllocateRequestResources;
} WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY, *PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY;

成員

Size

這個 結構的長度，以位元組為單位。

TotalForwardProgressRequests

架構將嘗試保留以用於低記憶體情況的要求物件數目。 此數字必須大於零。

ForwardProgressReservedPolicy

WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY型別值，指定架構如何在低記憶體情況下配置要求物件。

ForwardProgressReservePolicySettings

WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS 結構，其中包含 ForwardProgressReservedPolicy 成員所指定原則特有的其他值。 除非驅動程式提供 EvtIoWdmIrpForForwardProgress 回呼函式，否則此成員應該是 NULL。

EvtIoAllocateResourcesForReservedRequest

驅動程式佇列特定 EvtIoAllocateResourcesForReservedRequest 回呼函式的指標，或 NULL。

EvtIoAllocateRequestResources

驅動程式佇列特定 EvtIoAllocateRequestResources 回呼函式的指標，或 NULL。

備註

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY 結構會當做 WdfIoQueueAssignForwardProgressPolicy 方法的輸入使用。

驅動程式必須先呼叫 WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT、WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_EXAMINE_INIT 或 WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_PAGINGIO_INIT，才能呼叫 WdfIoQueueAssignForwardProgressPolicy 來初始化WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY結構。

規格需求

需求 值
最低 KMDF 版本 1.9
標頭 wdfio.h (包含 Wdf.h)