KsInitializeDevice 함수(ks.h)

아티클
03/15/2022
읽는 데 2분 걸림

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