Функция 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 отдельно.

Требования

См. также

DEVICE_OBJECT

DRIVER_OBJECT

KSDEVICE

KsCreateDevice

KsDispatchIrp

KsInitializeDevice

KsInitializeDriver