Функция KsInitializeDevice (ks.h)
Функция 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. Мини-drivers, вызывающие эту функцию, напрямую отвечают за вызов IoCreateDevice и присоединение себя к стеку устройств.
[in] PhysicalDeviceObject
Указатель на DEVICE_OBJECT структуру, представляющую объект физического устройства WDM для инициализированного устройства.
[in] NextDeviceObject
Указатель на следующую структуру DEVICE_OBJECT в стеке устройств, определяемую вызовом IoAttachDeviceToDeviceStack.
[in, optional] Descriptor
Указатель на структуру KSDEVICE_DESCRIPTOR, описывающую характеристики инициализированного устройства. Если этот параметр null, устройство инициализируется с характеристиками по умолчанию и не имеет связанных фабрик фильтров.
Возвращаемое значение
KsInitializeDevice возвращает STATUS_SUCCESS, если устройство успешно инициализировано. В противном случае возвращается соответствующий код ошибки.
Замечания
Большинство мини-накопителей не вызывают эту функцию напрямую. Вызов KsInitializeDevice, если мини-driver не использует KsInitializeDriver для инициализации, обрабатывает AddDevice независимо и не использует KsAddDevice или KsCreateDevice в обработчике addDevice.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Microsoft Windows XP и более поздних операционных системах и версиях DirectX 8.0 и более поздних версий DirectX. |
| целевая платформа | Всеобщий |
| заголовка | ks.h (include Ks.h) |
| библиотеки | Ks.lib |
| IRQL | PASSIVE_LEVEL |