WdfDeviceGetDefaultQueue 함수(wdfdevice.h)

[KMDF 및 UMDF에 적용]

WdfDeviceGetDefaultQueue 메서드는 디바이스의 기본 I/O 큐에 대한 핸들을 반환합니다.

구문

WDFQUEUE WdfDeviceGetDefaultQueue(
  [in] WDFDEVICE Device
);

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

반환 값

작업이 성공하면 메서드는 프레임워크 큐 개체에 대한 핸들을 반환합니다. 드라이버가 디바이스에 대한 기본 I/O 큐를 만들지 않은 경우 메서드는 NULL을 반환합니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

기본 I/O 큐에 대한 자세한 내용은 I/O 큐 만들기를 참조하세요.

예제

다음 코드 예제에서는 디바이스의 기본 I/O 큐에 대한 핸들을 가져옵니다.

WDFQUEUE DefaultQueue;

DefaultQueue = WdfDeviceGetDefaultQueue(Device);

요구 사항

요구 사항
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
최소 UMDF 버전 2.0
머리글 wdfdevice.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL <= DISPATCH_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)