WdfPdoInitAssignRawDevice 함수(wdfpdo.h)

아티클
08/08/2023

[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)