Функция KsInitializeDevice (ks.h)

Статья
08/07/2023

Функция KsInitializeDevice вызывается AVStream для инициализации класса устройства AVStream из KsCreateDevice.

Синтаксис

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

Параметры

[in] FunctionalDeviceObject

Указатель на структуру DEVICE_OBJECT , представляющую функциональный объект устройства WDM для инициализируемого устройства.

Как правило, это возвращается из вызова IoCreateDevice . Мини-накопители, вызывающие эту функцию напрямую, отвечают за вызов IoCreateDevice и подключение к стеку устройств.

[in] PhysicalDeviceObject

Указатель на структуру DEVICE_OBJECT , представляющую объект физического устройства WDM для инициализируемого устройства.

[in] NextDeviceObject

Указатель на следующую DEVICE_OBJECT структуру в стеке устройств, определяемую вызовом IoAttachDeviceToDeviceStack.

[in, optional] Descriptor

Указатель на структуру KSDEVICE_DESCRIPTOR , которая описывает характеристики инициализируемого устройства. Если этот параметр имеет значение NULL, устройство инициализируется с характеристиками по умолчанию и не имеет связанных фабрик фильтров.

Возвращаемое значение

KsInitializeDevice возвращает STATUS_SUCCESS, если устройство было успешно инициализировано. В противном случае возвращается соответствующий код ошибки.

Большинство мини-драйверов не вызывают эту функцию напрямую. Вызовите KsInitializeDevice , только если ваш мини-диск не использует KsInitializeDriver для инициализации, обрабатывает AddDevice независимо и не использует KsAddDevice или KsCreateDevice в обработчике AddDevice .

Требования

Требование	Значение
Минимальная версия клиента	Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях.
Целевая платформа	Универсальное
Верхняя часть	ks.h (включая Ks.h)
Библиотека	Ks.lib
IRQL	PASSIVE_LEVEL