WdfDeviceInitSetDeviceType 함수(wdfdevice.h)

  • 아티클

[KMDF에만 적용]

WdfDeviceInitSetDeviceType 메서드는 지정된 디바이스의 디바이스 유형을 설정합니다.

구문

void WdfDeviceInitSetDeviceType(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] DEVICE_TYPE     DeviceType
);

매개 변수

[in] DeviceInit

WDFDEVICE_INIT 구조체에 대한 포인터입니다.

[in] DeviceType

디바이스 유형을 식별하는 FILE_DEVICE_XXXX 값입니다. FILE_DEVICE_XXXX 값에 대한 자세한 내용은 디바이스 유형 지정을 참조하세요.

반환 값

없음

설명

드라이버가 WdfDeviceInitSetDeviceType을 호출하는 경우 WdfDeviceCreate를 호출하기 전에 호출해야 합니다.

WdfDeviceCreate를 호출하는 방법에 대한 자세한 내용은 프레임워크 디바이스 개체 만들기를 참조하세요.

드라이버가 지정하는 디바이스 유형은 드라이버가 I/O 요청을 완료할 때 프레임워크에서 사용하는 기본 우선 순위 상승 값을 결정합니다. 우선 순위 상승 값에 대한 자세한 내용은 I/O 요청을 완료할 때 우선 순위 향상 지정을 참조하세요.

UMDF 드라이버를 작성하는 경우 드라이버의 INF 파일을 수정하거나 레지스트리를 변경하여 디바이스 유형을 지정해야 합니다. 레지스트리 사용에 대한 자세한 내용은 설치 중에 디바이스 개체 레지스트리 속성 설정을 참조하세요.

예제

다음 코드 예제는 디바이스가 직렬 디바이스임을 나타냅니다.

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
머리글 wdfdevice.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL <= DISPATCH_LEVEL
DDI 규정 준수 규칙 ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)