通过

KsReferenceBusObject 函数 （ks.h）

  • 项目

引用总线物理设备对象。

语法

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 （包括 Ks.h）
库 Ks.lib