Share via

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

  • Статья

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

Синтаксис

KSDDKAPI NTSTATUS KsReferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

Параметры

[in] Header

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

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

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

Комментарии

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

Требования

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