次の方法で共有

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
ヘッダー wdfio.h (Wdf.h を含む)