KsInitializeDriver 함수(ks.h)

아티클
07/14/2022
읽는 데 2분 걸림

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