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

メモリ不足の状況でフレームワークが使用のために予約しようとする要求オブジェクトの数。 この番号は 0 より大きくなければなりません。

ForwardProgressReservedPolicy

メモリ不足の状況でフレームワークが要求オブジェクトを割り当てる方法を指定する 、WDF_IO_FORWARD_PROGRESS_RESERVED_POLICY型指定された値。

ForwardProgressReservePolicySettings

ForwardProgressReservedPolicy メンバーが指定するポリシーに固有の追加の値を含むWDF_IO_FORWARD_PROGRESS_RESERVED_POLICY_SETTINGS構造体。 ドライバーが EvtIoWdmIrpForForwardProgress コールバック関数を提供しない限り、このメンバーは NULL である必要があります。

EvtIoAllocateResourcesForReservedRequest

ドライバーのキュー固有の EvtIoAllocateResourcesForReservedRequest コールバック関数へのポインター、または NULL。

EvtIoAllocateRequestResources

ドライバーのキュー固有の EvtIoAllocateRequestResources コールバック関数へのポインター、または NULL。

注釈

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY構造体は、WdfIoQueueAssignForwardProgressPolicy メソッドへの入力として使用されます。

ドライバーは、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を呼び出して、WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY構造体を初期化する必要があります。

要件

要件	値
最小 KMDF バージョン	1.9
Header	wdfio.h (Wdf.h を含む)