Функция KsSetTargetDeviceObject (ks.h)
Функция KsSetTargetDeviceObject задает целевой объект устройства объекта. Функция добавляет заголовок объекта в список заголовков объектов, имеющих целевые устройства.
Синтаксис
KSDDKAPI VOID KsSetTargetDeviceObject(
[in] KSOBJECT_HEADER Header,
[in, optional] PDEVICE_OBJECT TargetDevice
);
Параметры
[in] Header
Указывает на заголовок, ранее выделенный KsAllocateObjectHeader.
[in, optional] TargetDevice
При необходимости содержит целевой объект устройства, который будет использоваться при пересчете глубины стека для базового объекта устройства. Если значение равно NULL, удаляется любой текущий параметр. Если значение имеет какой-либо параметр, отличный от NULL, то текущий параметр заменяется.
Возвращаемое значение
Никакой
Замечания
Функция KsSetTargetDeviceObject предполагает, что вызывающий объект ранее выделил заголовок устройства на базовом объекте устройства с функцией KsAllocateDeviceHeader. Наличие заголовка устройства позволяет будущим вызовам функции KsRecalculateStackDepth, а заголовок устройства используется, когда объект перенаправит irPs через подключение к другому устройству и должен отслеживать глубину стека.
Если KsSetDevicePnpAndBaseObject также используется для назначения стека объектов PnP, этот объект устройства также будет учитываться при пересчете глубины стека.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | ks.h (include Ks.h) |
| библиотеки | Ks.lib |