Fonction de rappel PFNKSFILTERPROCESS (ks.h)

La routine AVStrMiniFilterProcess d’un minidriver AVStream est appelée lorsque le filtre est destiné à traiter les images. Il est utilisé pour effectuer un traitement centré sur les filtres.

Syntaxe

PFNKSFILTERPROCESS Pfnksfilterprocess;

NTSTATUS Pfnksfilterprocess(
  [in] PKSFILTER Filter,
       PKSPROCESSPIN_INDEXENTRY Index
)
{...}

Paramètres

[in] Filter

Pointeur vers la structure KSFILTER qui doit traiter les trames.

Index

Pointeur vers un tableau de structures KSPROCESSPIN_INDEXENTRY que AVStream commande par ID d’épingle.

Valeur retournée

Retournez STATUS_SUCCESS pour poursuivre le traitement. Retournez STATUS_PENDING pour arrêter le traitement jusqu’à l’événement de déclenchement suivant. Le minidriver peut retourner un code d’erreur, mais il sera traité comme décrit pour STATUS_PENDING.

Remarques

Le minidriver spécifie l’adresse de cette routine dans le membre Process de sa structure KSFILTER_DISPATCH .

La routine est appelée à l’adresse IRQL = DISPATCH_LEVEL ou PASSIVE_LEVEL en fonction de la préférence exprimée dans le descripteur de filtre. Les descripteurs de filtre qui spécifient KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSING peuvent avoir leur rappel de processus à DISPATCH_LEVEL ; les descripteurs de filtre qui ne spécifient pas cet indicateur auront leur rappel de processus à PASSIVE_LEVEL.

Pour plus d’informations, consultez Traitement centré sur les filtres et redémarrage du traitement dans AVStream.

Cette routine est facultative.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX.
Plateforme cible Desktop (Expérience utilisateur)
En-tête ks.h (inclure Ks.h)
IRQL (Voir la section Remarques)

Voir aussi

KSFILTER_DISPATCH

KSPROCESSPIN_INDEXENTRY