Skip to content

Latest commit

 

History

History
74 lines (57 loc) · 2.84 KB

nc-ks-pfnksfilterprocess.md

File metadata and controls

74 lines (57 loc) · 2.84 KB
UID title description tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NC:ks.PFNKSFILTERPROCESS
PFNKSFILTERPROCESS (ks.h)
An AVStream minidriver's AVStrMiniFilterProcess routine is called when the filter is meant to process frames. It is used to perform Filter-Centric Processing.
stream
07/13/2022
PFNKSFILTERPROCESS callback function
AVStrMiniFilterProcess, AVStrMiniFilterProcess routine [Streaming Media Devices], PFNKSFILTERPROCESS, avstclbk_220bff5f-a966-460b-9157-b512cfc9c336.xml, ks/AVStrMiniFilterProcess, stream.avstrminifilterprocess
ks.h
Ks.h
Desktop
Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.
(See Remarks section)
Windows
PFNKSFILTERPROCESS
ks/PFNKSFILTERPROCESS
APIRef
kbSyntax
UserDefined
ks.h
PFNKSFILTERPROCESS

-description

An AVStream minidriver's AVStrMiniFilterProcess routine is called when the filter is meant to process frames. It is used to perform Filter-Centric Processing.

-parameters

-param Filter [in]

Pointer to the KSFILTER structure that must process frames.

-param Index

Pointer to an array of KSPROCESSPIN_INDEXENTRY structures that AVStream orders by pin ID.

-returns

Return STATUS_SUCCESS to continue processing. Return STATUS_PENDING to stop processing until the next triggering event. The minidriver may return an error code, but this will be treated as described for STATUS_PENDING.

-remarks

The minidriver specifies this routine's address in the Process member of its KSFILTER_DISPATCH structure.

The routine is called at either IRQL = DISPATCH_LEVEL or PASSIVE_LEVEL depending on the preference expressed in the filter descriptor. Filter descriptors that specify KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSING may have their process callback at DISPATCH_LEVEL; filter descriptors that do not specify this flag will have their process callback at PASSIVE_LEVEL.

For more information, see Filter-Centric Processing and Restarting Processing in AVStream.

This routine is optional.

-see-also

KSFILTER_DISPATCH

KSPROCESSPIN_INDEXENTRY