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

Разыменовывает объект физического устройства шины.

Синтаксис

KSDDKAPI VOID KsDereferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

Параметры

[in] Header

Указывает на заголовок, ранее выделенный KsAllocateDeviceHeader , который также содержит объект стека устройств PnP.

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

Нет.

Remarks

Это используется фильтрами, которые используют заголовок устройства для отслеживания соответствующего стека объектов PnP. Обычно это вызывается при закрытии фильтра, если это требуется шине для данного устройства. Например, для программного устройства потребуется такой вызов. Этот вызов соответствует предыдущему вызову KsReferenceBusObject при открытии экземпляра фильтра. Чтобы задать объект стека устройств PnP, вызывающий объект должен также вызываться KsSetDevicePnpAndBaseObject . Это было бы сделано в функции PnP AddDevice . Функция вызывает метод DereferenceDeviceObject в ранее полученном интерфейсе. Сам интерфейс освобождается и освобождается при освобождении заголовка устройства.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ks.h)
Библиотека Ks.lib