WdfPdoInitAssignRawDevice 함수(wdfpdo.h)
[KMDF에만 적용]
WdfPdoInitAssignRawDevice 메서드는 호출 드라이버가 원시 모드에서 지정된 디바이스를 지원할 수 있음을 나타냅니다.
구문
NTSTATUS WdfPdoInitAssignRawDevice(
[in] PWDFDEVICE_INIT DeviceInit,
[in] const GUID *DeviceClassGuid
);
매개 변수
[in] DeviceInit
WDFDEVICE_INIT 구조체에 대한 포인터입니다.
[in] DeviceClassGuid
디바이스 설정 클래스를 식별하는 GUID에 대한 포인터입니다.
참고 항상 사용자 지정 클래스 GUID를 지정해야 합니다. 기존 클래스 GUID를 지정해서는 안 됩니다. 기존 클래스 GUID를 지정하는 경우 기존 클래스 GUID를 지정하려는 다른 드라이버가 설치에 실패하거나 잘못된 보안 설정으로 설치될 수 있습니다.
자세한 내용은 아래 설명 부분을 참조하십시오.
반환 값
작업이 성공하면 메서드는 STATUS_SUCCESS 반환합니다. 그렇지 않으면 STATUS_INVALID_PARAMETER 반환합니다.
설명
드라이버는 WdfDeviceCreate를 호출하기 전에 WdfPdoInitAssignRawDevice를 호출해야 합니다. WdfDeviceCreate를 호출하는 방법에 대한 자세한 내용은 프레임워크 디바이스 개체 만들기를 참조하세요.
레지스트리에는 드라이버가 WdfDeviceInitAssignSDDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristics 및 WdfDeviceInitSetExclusive를 호출할 때 지정하는 값을 재정의하는 값이 포함될 수 있습니다. WdfPdoInitAssignRawDevice 메서드의 DeviceClassGuid 매개 변수는 재정의 값이 포함된 레지스트리의 섹션을 식별하는 GUID를 지정합니다. DeviceClassGuid 매개 변수는 레지스트리의 섹션만 식별하고 실제로 디바이스에 대한 디바이스 설정 클래스를 설정하지 않습니다. 디바이스 및 드라이버의 INF 파일의 INF 버전 섹션에서 디바이스 설정 클래스를 설정합니다. 일반적으로 DeviceClassGuid 매개 변수의 GUID는 INF 버전 섹션에서 지정하는 GUID와 일치해야 합니다.
레지스트리 사용에 대한 자세한 내용은 설치 후 디바이스 개체 레지스트리 속성 설정을 참조하세요.
예제
kmdf_enumswitches 드라이버 샘플의 다음 코드 조각은 드라이버가 원시 모드에서 지정된 디바이스를 지원할 수 있음을 나타냅니다.
NTSTATUS status;
DEFINE_GUID(GUID_DEVCLASS_MYUNIQUEID,
0xf149fe88, 0x f6cc, 0x47e3, 0x85, 0x94, 0xe2, 0xaa, 0xb6, 0xe0, 0x3b, 0xdf);
status = WdfPdoInitAssignRawDevice(
pDeviceInit,
&GUID_DEVCLASS_MYUNIQUEID
);
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 머리글 | wdfpdo.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조) |
| IRQL | PASSIVE_LEVEL |
| DDI 규정 준수 규칙 | ChildDeviceInitAPI(kmdf), DriverCreate(kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeNull(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf) |