다음을 통해 공유

WDFDEVICE_INIT 구조체

  • 아티클

[KMDF 및 UMDF에 적용]

WDFDEVICE_INIT 구조체는 프레임워크에서 정의하고 할당하는 불투명 구조체입니다.

구문

struct WDFDEVICE_INIT {
  ;      // Reserved.
};

멤버

함수 및 필터 드라이버는 이 구조체에 대한 포인터를 EvtDriverDeviceAdd 콜백 함수에 대한 입력 또는 WdfControlDeviceInitAllocate의 반환 값으로 받습니다.

버스 드라이버는 구조 포인터를 EvtChildListCreateDevice 콜백 함수에 대한 입력 또는 WdfPdoInitAllocate의 반환 값으로 받습니다.

드라이버는 WDFDEVICE_INIT 구조체를 수신한 후 구조체 포인터를 초기화 함수에 전달합니다. 이러한 함수는 WDFDEVICE_INIT 구조를 사용하여 프레임워크가 프레임워크 디바이스 개체를 만드는 데 사용하는 정보를 저장합니다.

디바이스 초기화 방법에 대한 설명서를 찾으려면 wdfdevice.h 헤더를 참조하세요.

초기화 함수를 호출한 후 드라이버는 WdfDeviceCreate를 호출하여 프레임워크 디바이스 개체를 만들어야 합니다.

드라이버가 WdfPdoInitAllocate 또는 WdfControlDeviceInitAllocate 호출에서 WDFDEVICE_INIT 구조를 수신하고 드라이버가 초기화 함수를 호출하는 오류를 수신하는 경우 드라이버는 WdfDeviceCreate 대신 WdfDeviceInitFree를 호출해야 합니다.

WdfDeviceCreate를 성공적으로 호출한 후에는 드라이버가 WdfDeviceInitFree를 호출하지 않아야 합니다.

WDFDEVICE_INIT 구조는 버전 1.0 이상 버전의 KMDF에서 사용할 수 있습니다.

요구 사항

헤더

 Wdftypes.h(Wdftypes.h 포함)