KsDereferenceBusObject function (ks.h)
Dereferences the bus Physical Device Object.
Syntax
KSDDKAPI VOID KsDereferenceBusObject(
[in] KSDEVICE_HEADER Header
);
Parameters
[in] Header
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
Requirement | Value |
---|---|
Target Platform | Universal |
Header | ks.h (include Ks.h) |
Library | Ks.lib |