Функция 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.

Требования

См. также

DEVICE_OBJECT

DRIVER_OBJECT

IoAttachDeviceToDeviceStack

IoCreateDevice

KSDEVICE

KsAddDevice

KsCreateDevice

KsInitializeDriver

KsTerminateDevice