WdfDeviceInitSetDeviceClass 함수(wdfdevice.h)
[KMDF에만 적용]
WdfDeviceInitSetDeviceClass 메서드는 디바이스의 디바이스 설정 클래스를 식별하는 GUID를 지정합니다.
구문
void WdfDeviceInitSetDeviceClass(
[in] PWDFDEVICE_INIT DeviceInit,
[in] const GUID *DeviceClassGuid
);
매개 변수
[in] DeviceInit
WDFDEVICE_INIT 구조체에 대한 포인터입니다.
[in] DeviceClassGuid
DefaultSDDLString, DeviceType, DeviceCharacteristics 및 Exclusive 매개 변수에 대한 가능한 재정의가 포함된 레지스트리의 섹션을 식별하는 GUID에 대한 포인터입니다.
반환 값
없음
설명
레지스트리에는 드라이버가 WdfDeviceInitAssignSDDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristics 및 WdfDeviceInitSetExclusive를 호출할 때 지정하는 값을 재정의하는 값이 포함될 수 있습니다. 드라이버는 WdfDeviceInitSetDeviceClass 를 호출하여 재정의 값이 포함된 레지스트리의 섹션을 식별하는 GUID를 지정할 수 있습니다.
일반적으로 드라이버는 제어 디바이스를 만드는 경우에만 WdfDeviceInitSetDeviceClass를 호출합니다.
레지스트리 사용에 대한 자세한 내용은 설치 후 디바이스 개체 레지스트리 속성 설정을 참조하세요.
드라이버가 WdfDeviceInitSetDeviceClass를 호출하는 경우 WdfDeviceCreate를 호출하기 전에 호출해야 합니다.
WdfDeviceCreate를 호출하는 방법에 대한 자세한 내용은 프레임워크 디바이스 개체 만들기를 참조하세요.
예제
다음 코드 예제에서는 디바이스의 설정 클래스를 시스템 디바이스 클래스로 설정합니다.
DEFINE_GUID(GUID_DEVCLASS_MYUNIQUEID,
0xf149fe88, 0x f6cc, 0x47e3, 0x85, 0x94, 0xe2, 0xaa, 0xb6, 0xe0, 0x3b, 0xdf);
WdfDeviceInitSetDeviceClass(
DeviceInit,
&GUID_DEVCLASS_MYUNIQUEID
);
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 유니버설 |
최소 KMDF 버전 | 1.0 |
머리글 | wdfdevice.h(Wdf.h 포함) |
라이브러리 | Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조) |
IRQL | <= DISPATCH_LEVEL |
DDI 규정 준수 규칙 | ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |