WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE 함수(wdfio.h)

아티클
02/27/2024

[KMDF 및 UMDF에 적용]

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

구문

void WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE(
  [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_DEFAULT_QUEUE 호출해야 합니다. WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE 함수는 지정된 WDF_IO_QUEUE_CONFIG 구조체를 0으로 설정하고 Size 멤버를 설정합니다. 또한 PowerManaged 멤버를 WdfUseDefault로 설정하고 DefaultQueue 멤버를 TRUE로 설정하며 지정된 디스패치 형식을 DispatchType 멤버에 저장합니다.

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

WDF_IO_QUEUE_CONFIG_INIT_DEFAULT_QUEUE 사용하는 코드 예제는 WdfIoQueueCreate를 참조하세요.