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

Статья
02/29/2024

Функция KsInitializeDriver инициализирует объект драйвера мини-драйвера AVStream.

Синтаксис

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

Параметры

[in] DriverObject

Указатель на структуру DRIVER_OBJECT для инициализируемого драйвера AVStream. Мини-накопители, вызывающие KsInitializeDriver, должны использовать объект driver, переданный в DriverEntry операционной системой.

[in] RegistryPathName

Указатель на строку Юникода, содержащую строку пути к реестру, переданную операционной системой в функцию DriverEntry minidriver.

[in, optional] Descriptor

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

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

KsInitializeDriver возвращает STATUS_SUCCESS или соответствующий код ошибки, возвращенный ioCreateDevice или внутренними подпрограммами инициализации устройств AVStream.

Эта функция обычно вызывается из DriverEntry. Если мини-диск передает дескриптор устройства, AVStream создает устройство с указанными характеристиками во время AddDevice . Мини-устройствам, выполняющим инициализацию устройств, необязательно вызывать KsInitializeDriver. Дополнительные сведения см. в разделе Инициализация avStream Minidriver.

Требования

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