KsInitializeDriver 함수(ks.h)

아티클
02/26/2024

KsInitializeDriver 함수는 AVStream 미니드라이버의 드라이버 개체를 초기화합니다.

구문

KSDDKAPI NTSTATUS KsInitializeDriver(
  [in]           PDRIVER_OBJECT            DriverObject,
  [in]           PUNICODE_STRING           RegistryPathName,
  [in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);

매개 변수

[in] DriverObject

초기화되는 AVStream 드라이버의 DRIVER_OBJECT 구조체에 대한 포인터입니다. KsInitializeDriver를 호출하는 미니드라이버에서는 운영 체제에서 DriverEntry에 전달된 드라이버 개체를 사용해야 합니다.

[in] RegistryPathName

운영 체제에서 미니 드라이버의 DriverEntry 함수에 전달된 레지스트리 경로 문자열을 포함하는 유니코드 문자열에 대한 포인터입니다.

[in, optional] Descriptor

초기화되는 디바이스의 특성을 지정하는 KSDEVICE_DESCRIPTOR 구조체에 대한 포인터입니다. 이 포인터가 NULL이면 디바이스가 기본 특성과 연결된 필터 팩터리를 사용하지 않고 만들어집니다.

반환 값

KsInitializeDriver는IoCreateDevice 또는 내부 AVStream 디바이스 초기화 루틴에서 반환된 STATUS_SUCCESS 또는 적절한 오류 코드를 반환합니다.

설명

이 함수는 일반적으로 DriverEntry에서 호출됩니다. 미니드라이버가 디바이스 설명자를 통과하는 경우 AVStream은 AddDevice 시간에 지정된 특성을 가진 디바이스를 만듭니다. 디바이스 초기화를 수행하는 미니드라이버가 KsInitializeDriver를 호출할 필요는 없습니다. 자세한 내용은 AVStream Minidriver 초기화를 참조하세요.

요구 사항

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