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