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

Статья
02/07/2025

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

Синтаксис

KSDDKAPI NTSTATUS KsReferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

Параметры

[in] Header

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

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

Возвращает STATUS_SUCCESS, если ссылка была успешной, в противном случае ошибка, например STATUS_INSUFFICIENT_RESOURCES.

Замечания

Эта функция используется фильтрами, используюющими заголовок устройства для отслеживания стека объектов PnP. Обычно это вызывается при успешном открытии фильтра, когда шина для этого устройства требует такой ссылки (например, программных устройств) и сопоставляется с вызовом KsDereferenceBusObject в близком экземпляре фильтра. Вызывающий объект должен ранее называться KsSetDevicePnpAndBaseObject, чтобы задать объект стека устройств PnP. Это было бы сделано в функции PnP AddDevice. Если объект не был указан ранее, пространство интерфейса выделяется, а функция использует объект устройства PnP для получения интерфейса ссылки на шину. Затем он вызывает метод ReferenceDeviceObject в этом интерфейсе. Сам интерфейс освобождается и освобождается при освобождении заголовка устройства.

Требования

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

Поделиться через