Функция KsSetTargetDeviceObject (ks.h)

Статья
08/07/2023

Функция KsSetTargetDeviceObject задает объект целевого устройства объекта . Функция добавляет заголовок объекта в список заголовков объектов с целевыми устройствами.

Синтаксис

KSDDKAPI VOID KsSetTargetDeviceObject(
  [in]           KSOBJECT_HEADER Header,
  [in, optional] PDEVICE_OBJECT  TargetDevice
);

Параметры

[in] Header

Указывает на заголовок, ранее выделенный KsAllocateObjectHeader.

[in, optional] TargetDevice

При необходимости содержит объект целевого устройства, который будет использоваться при пересчете глубины стека для базового объекта устройства. Если значение равно NULL, все текущие параметры удаляются. Если значение равно любому параметру, отличному от NULL, текущий параметр заменяется.

Возвращаемое значение

None

Remarks

Функция KsSetTargetDeviceObject предполагает, что вызывающий объект ранее выделил заголовок устройства в базовом объекте устройства с помощью функции KsAllocateDeviceHeader . Наличие заголовка устройства позволяет в будущем вызывать функцию KsRecalculateStackDepth, а заголовок устройства используется, когда объект будет перенаправлять IRP через подключение к другому устройству и должен отслеживать глубину стека.

Если KsSetDevicePnpAndBaseObject также используется для назначения стека объектов PnP, этот объект устройства также будет учитываться при пересчете глубины стека.