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)

See also

KSFILTER_DISPATCH