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)
Library	Ks.lib