KsDereferenceBusObject 函数 (ks.h)

取消引用总线物理设备对象。

语法

KSDDKAPI VOID KsDereferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

参数

[in] Header

指向以前由 KsAllocateDeviceHeader 分配的标头,该标头也包含 PnP 设备堆栈对象。

返回值

无。

备注

这由使用设备标头的筛选器用来跟踪相应的 PnP 对象堆栈。 如果给定设备的总线需要,通常会在关闭筛选器时调用此函数。 例如,软件设备需要此类调用。 此调用与打开筛选器实例时对 KsReferenceBusObject 的先前调用匹配。 调用方之前必须具有 KsSetDevicePnpAndBaseObject 才能设置 PnP 设备堆栈对象。 这本来是在 PnP AddDevice 函数中完成的。 函数在以前检索的接口上调用 DereferenceDeviceObject 方法。 释放设备标头时,会释放和释放接口本身。

要求

   
目标平台 通用
标头 ks.h (包括 Ks.h)
Library Ks.lib