PFNKSFILTERVOID callback function (ks.h)
An AVStream minidriver's AVStrMiniFilterReset routine is called when AVStream receives an IOCTL_KS_RESET_STATE to return the filter to the state it was in at Acquire-time. This routine is also called when a queue associated with a pin on the filter is flushed. This routine will only be called for a filter-centric filter.
Syntax
PFNKSFILTERVOID Pfnksfiltervoid;
NTSTATUS Pfnksfiltervoid(
[in] PKSFILTER Filter
)
{...}
Parameters
[in] Filter
Pointer to the KSFILTER to return to its previous state.
Return value
AVStream does not currently use the return value.
Remarks
For more information, see Filter-Centric Processing.
Note that it is not the filter in question, but rather a pin on this filter that actually receives the reset IOCTL.
The minidriver specifies this routine's address in the Reset member of its KSFILTER_DISPATCH structure.
The filter control mutex may be held during this function. See Filter Control Mutex in AVStream.
This routine is optional.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions. |
| Target Platform | Desktop |
| Header | ks.h (include Ks.h) |