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 포함)