Функция KsInitializeDriver (ks.h)
Функция 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 |