WdfPdoInitAllocate 함수(wdfpdo.h)

  • 아티클

[KMDF에만 적용]

WdfPdoInitAllocate 메서드는 새 디바이스를 보고할 때 버스 드라이버가 사용하는 프레임워크 기반 버스 드라이버에 대한 WDFDEVICE_INIT 구조를 할당합니다.

구문

PWDFDEVICE_INIT WdfPdoInitAllocate(
  [in] WDFDEVICE ParentDevice
);

매개 변수

[in] ParentDevice

새 디바이스의 부모 디바이스를 나타내는 프레임워크 디바이스 개체에 대한 핸들입니다. 프레임워크 디바이스 개체는 FDO(기능 디바이스 개체)를 나타내야 합니다.

반환 값

작업이 성공하면 메서드는 프레임워크 할당 WDFDEVICE_INIT 구조체에 대한 포인터를 반환합니다. 그렇지 않으면 메서드는 NULL을 반환합니다.

설명

버스 드라이버가 정적 열거형을 사용하는 경우 다음을 통해 새 디바이스를 보고합니다.

  1. WdfPdoInitAllocate를 호출하여 WDFDEVICE_INIT 구조를 할당합니다.
  2. 필요에 따라 프레임워크 디바이스 개체 초기화 메서드 및 프레임워크 PDO 초기화 메서드를 호출하여 WDFDEVICE_INIT 구조를 초기화합니다. 이러한 메서드 중 하나에 대한 호출이 실패하면 드라이버는 WdfDeviceInitFree를 호출해야 합니다.
  3. WdfDeviceCreate를 호출하여 프레임워크 디바이스 개체를 만들고 초기화된 WDFDEVICE_INIT 구조를 입력으로 제공합니다.
정적 열거형에 대한 자세한 내용은 버스에서 디바이스 열거를 참조하세요.

예제

WdfPdoInitAllocate를 사용하는 코드 예제는 WdfFdoAddStaticChild를 참조하세요.

요구 사항

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

추가 정보

WdfControlDeviceInitAllocate