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에 대한 포인터입니다.

참고 항상 사용자 지정 클래스 GUID를 지정해야 합니다. 기존 클래스 GUID를 지정해서는 안 됩니다. 기존 클래스 GUID를 지정하는 경우 기존 클래스 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)