KsInitializeDevice 함수(ks.h)

아티클
02/26/2024

KsInitializeDevice 함수는 AVStream에서 호출되어 KsCreateDevice 내에서 AVStream 디바이스 클래스를 초기화합니다.

구문

KSDDKAPI NTSTATUS KsInitializeDevice(
  [in]           PDEVICE_OBJECT            FunctionalDeviceObject,
  [in]           PDEVICE_OBJECT            PhysicalDeviceObject,
  [in]           PDEVICE_OBJECT            NextDeviceObject,
  [in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);

매개 변수

[in] FunctionalDeviceObject

초기화되는 디바이스에 대한 WDM 기능 디바이스 개체를 나타내는 DEVICE_OBJECT 구조체에 대한 포인터입니다.

일반적으로 IoCreateDevice 호출에서 반환됩니다. 이 함수를 직접 호출하는 미니드라이버에서는 IoCreateDevice 를 호출하고 디바이스 스택에 직접 연결해야 합니다.

[in] PhysicalDeviceObject

초기화되는 디바이스에 대한 WDM 물리적 디바이스 개체를 나타내는 DEVICE_OBJECT 구조체에 대한 포인터입니다.

[in] NextDeviceObject

IoAttachDeviceToDeviceStack 호출에 의해 결정되는 디바이스 스택의 다음 DEVICE_OBJECT 구조체에 대한 포인터입니다.

[in, optional] Descriptor

초기화되는 디바이스의 특성을 설명하는 KSDEVICE_DESCRIPTOR 구조체에 대한 포인터입니다. 이 매개 변수가 NULL이면 디바이스가 기본 특성으로 초기화되고 연결된 필터 팩터리는 없습니다.

반환 값

KsInitializeDevice 는 디바이스가 성공적으로 초기화되면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.

설명

대부분의 미니 드라이버는 이 함수를 직접 호출하지 않습니다. 미니드라이버가 초기화에 KsInitializeDriver를 사용하지 않고, AddDevice를 독립적으로 처리하고, AddDevice 처리기에서 KsAddDevice 또는 KsCreateDevice를 사용하지 않는 경우에만 KsInitializeDevice를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	ks.h(Ks.h 포함)
라이브러리	Ks.lib
IRQL	PASSIVE_LEVEL