WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT 함수(wdfio.h)

아티클
03/22/2025

[KMDF에만 적용]

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT 함수는 드라이버의 WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY 구조를 초기화합니다.

구문론

void WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT(
  [out] PWDF_IO_QUEUE_FORWARD_PROGRESS_POLICY Policy,
  [in]  ULONG                                 TotalForwardProgressRequests
);

매개 변수

[out] Policy

드라이버의 WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY 구조체에 대한 포인터입니다.

[in] TotalForwardProgressRequests

프레임워크가 메모리 부족 상황에서 사용하기 위해 예약하려고 시도하는 요청 개체의 수입니다. 이 숫자는 0보다 커야 합니다.

반환 값

없음

비고

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT 함수는 지정된 WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY 구조체를 0으로 설정하고 Size 멤버를 설정합니다. 또한 구조체의 TotalForwardProgressRequests 멤버를 지정된 값으로 설정하고 ForwardProgressReservedPolicy 멤버를 WdfIoForwardProgressReservedPolicyAlwaysUseReservedRequest설정합니다.

예시

다음 코드 예제에서는 WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY 구조를 초기화한 다음 WdfIoQueueAssignForwardProgressPolicy 호출합니다. 이 예제에서 드라이버는 메모리 부족 상황에 대해 프레임워크가 10개의 요청 개체를 할당하고 예약해야 하므로 지정합니다.

#define MAX_RESERVED_REQUESTS 10

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY queueForwardProgressPolicy;
WDFQUEUE readQueue;
NTSTATUS status = STATUS_SUCCESS;

WDF_IO_QUEUE_FORWARD_PROGRESS_POLICY_DEFAULT_INIT(
                                                  &queueForwardProgressPolicy,
                                                  MAX_RESERVED_REQUESTS
                                                  );
status = WdfIoQueueAssignForwardProgressPolicy(
                                               readQueue,
                                               &queueForwardProgressPolicy
                                               );