WDF_IO_QUEUE_CONFIG_INIT 함수(wdfio.h)

아티클
02/27/2024

[KMDF 및 UMDF에 적용]

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

구문

void WDF_IO_QUEUE_CONFIG_INIT(
  [out] PWDF_IO_QUEUE_CONFIG       Config,
  [in]  WDF_IO_QUEUE_DISPATCH_TYPE DispatchType
);

매개 변수

[out] Config

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

[in] DispatchType

큐에 대한 요청 디스패치 유형을 식별하는 WDF_IO_QUEUE_DISPATCH_TYPE 열거자입니다.

반환 값

없음

설명

드라이버는 디바이스의 기본 큐가 아닌 전원 관리형 I/O 큐를 만들 때 WDF_IO_QUEUE_CONFIG_INIT 호출해야 합니다. WDF_IO_QUEUE_CONFIG_INIT 함수는 지정된 WDF_IO_QUEUE_CONFIG 구조체를 0으로 설정하고 Size 멤버를 설정합니다. 또한 PowerManaged 멤버를 WdfUseDefault 로 설정하고 지정된 디스패치 형식을 DispatchType 멤버에 저장합니다.

KMDF 버전 1.9부터 DispatchType 이 WdfIoQueueDispatchParallel로 설정된 경우 WDF_IO_QUEUE_CONFIG_INIT 구조체의 NumberOfPresentedRequests 멤버를 -1로 설정합니다. 이 값은 프레임워크가 드라이버에 무제한의 I/O 요청을 제공할 수 있음을 나타냅니다.

예제

다음 코드 예제에서는 WDF_IO_QUEUE_CONFIG 구조를 초기화한 다음 WdfIoQueueCreate를 호출합니다.

WDF_IO_QUEUE_CONFIG  queueConfig;
NTSTATUS  status = STATUS_SUCCESS;
WDFQUEUE  readQueue;

WDF_IO_QUEUE_CONFIG_INIT(
                         &queueConfig,
                         WdfIoQueueDispatchManual
                         );
status = WdfIoQueueCreate(
                          hDevice,
                          &queueConfig,
                          WDF_NO_OBJECT_ATTRIBUTES,
                          &readQueue
                          );