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

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

Синтаксис

KSDDKAPI VOID KsDereferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

Параметры

[in] Header

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

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

Никакой.

Замечания

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

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	ks.h (include Ks.h)
библиотеки	Ks.lib