Функция KsInitializeDriver (ks.h)
Функция KsInitializeDriver инициализирует объект драйвера мини-driver AVStream.
Синтаксис
KSDDKAPI NTSTATUS KsInitializeDriver(
[in] PDRIVER_OBJECT DriverObject,
[in] PUNICODE_STRING RegistryPathName,
[in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);
Параметры
[in] DriverObject
Указатель на структуру DRIVER_OBJECT для инициализированного драйвера AVStream. Мини-drivers, вызывающие KsInitializeDriver, должны использовать объект драйвера, переданный DriverEntry операционной системой.
[in] RegistryPathName
Указатель на строку Юникода, содержащую строку пути реестра, передаваемую в функцию driverEntry DriverEntry операционной системой.
[in, optional] Descriptor
Указатель на структуру KSDEVICE_DESCRIPTOR, указывающую характеристики инициализированного устройства. Если этот указатель null, устройство создается с характеристиками по умолчанию и не связано с фабриками фильтров.
Возвращаемое значение
KsInitializeDriver возвращает STATUS_SUCCESS или соответствующий код ошибки, возвращаемый IoCreateDevice или внутренними подпрограммами инициализации устройств AVStream.
Замечания
Обычно эта функция вызывается из DriverEntry. Если мини-driver передает дескриптор устройства, AVStream создает устройство с указанными характеристиками в AddDevice времени. Мини-drivers, выполняющие инициализацию устройства, не обязательно должны вызывать KsInitializeDriver. Дополнительные сведения см. в разделе Инициализация мини-AVStream Minidriver.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Microsoft Windows XP и более поздних операционных системах и версиях DirectX 8.0 и более поздних версий DirectX. |
| целевая платформа | Всеобщий |
| заголовка | ks.h (include Ks.h) |
| библиотеки | Ks.lib |
| IRQL | PASSIVE_LEVEL |