Функция KsAddDevice (ks.h)
Функция KsAddDevice — это обработчик AddDevice по умолчанию, установленный KsInitializeDriver.
Синтаксис
KSDDKAPI NTSTATUS KsAddDevice(
[in] PDRIVER_OBJECT DriverObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject
);
Параметры
[in] DriverObject
Указатель на объект драйвера WDM для мини-драйвера.
[in] PhysicalDeviceObject
Указатель на объект физического устройства WDM.
Возвращаемое значение
Возвращает STATUS_SUCCESS, указывающие на успешное создание устройства или состояние ошибки из IoCreateDevice или KsInitializeDevice.
Комментарии
Обычно мини-накопитель AVStream не вызывает эту функцию напрямую.
Дополнительные сведения см. в статье AddDevice Routine for AVStream Minidrivers.
KsAddDevice извлекает дескриптор устройства, хранящийся в расширении устройства, выделенном из вызова KsInitializeDriver , и создает устройство, описанное им. Если KsInitializeDriver не используется для инициализации драйвера, эта функция создает устройство с характеристиками по умолчанию и без фабрик фильтров. Мини-driver всегда имеет возможность вызова KsCreateDevice напрямую, и в этом случае расширение драйвера не используется AVStream. Так как KsAddDevice вызывает KsCreateDevice, драйверы, вызывающие KsAddDevice , не должны вызывать KsCreateDevice отдельно.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версий. |
| Целевая платформа | Универсальное |
| Верхняя часть | ks.h (включая Ks.h) |
| Библиотека | Ks.lib |
| IRQL | PASSIVE_LEVEL |