KsDereferenceBusObject function

Dereferences the bus Physical Device Object.

Syntax


VOID KsDereferenceBusObject(
  _In_ KSDEVICE_HEADER Header
);

Parameters

Header [in]

Points to a header previously allocated by KsAllocateDeviceHeader that also contains the PnP device stack object.

Return value

None.

Remarks

This is used by filters that use the device header to keep track of the corresponding PnP object stack. This is normally called when closing a filter, if required by the bus for the given device. As an example, a software device would require such a call. This call matches a previous call to KsReferenceBusObject when opening the filter instance. The caller must have previously also called KsSetDevicePnpAndBaseObject in order to set the PnP device stack object. This would have been done in the PnP AddDevice function. The function calls the DereferenceDeviceObject method on the previously retrieved interface. The interface itself is released and freed when the device header is freed.

Requirements

Target platform

Universal

Header

Ks.h (include Ks.h)

Library

Ks.lib

 

 

Send comments about this topic to Microsoft

Show: