KsInitializeDevice 함수(ks.h)
KsInitializeDevice 함수는 KsCreateDevice내에서 AVStream 디바이스 클래스를 초기화하기 위해 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 사용하지 않는 경우에만 KsInitializeDevice 호출합니다. 는 AddDevice 독립적으로 처리하며 AddDevice 처리기에서 KsAddDevice 또는 KsCreateDevice 사용하지 않습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다. |
| 대상 플랫폼 | 보편적 |
| 헤더 | ks.h(Ks.h 포함) |
| 라이브러리 | Ks.lib |
| IRQL | PASSIVE_LEVEL |