Fonction de rappel PFNKSPIN (ks.h)
La routine de rappel d’un minidriver AVStream est appelée quand :
- Il existe des données disponibles pour une structure KSPIN à traiter. Utilisez cette routine pour effectuer Pin-Centric traitement.
- Le KSPIN approprié sert de broche de récepteur et est connecté à une broche source AVStream.
Syntaxe
PFNKSPIN Pfnkspin;
NTSTATUS Pfnkspin(
[in] PKSPIN Pin
)
{...}
Paramètres
[in] Pin
Pointeur vers le KSPIN qui dispose de données frame disponibles pour le traitement.
Valeur de retour
Retournez STATUS_SUCCESS pour continuer le traitement. Retournez STATUS_PENDING pour arrêter le traitement jusqu’à l’événement déclencheur suivant.
Remarques
À propos d’AVStrMiniPinProcess
Le minidriver spécifie l’adresse de cette routine dans le processus de membre de sa structure de KSPIN_DISPATCH.
Indiquez qu’un filtre utilise Pin-Centric traitement en fournissant cette fonction de répartition. Le minidriver définit des indicateurs de broche dans la structure KSPIN_DESCRIPTOR_EX appropriée qui déterminent quand AVStream appelle AVStrMiniPinProcess. Si le minidriver ne définit aucun indicateur dans le descripteur, le comportement par défaut est que AVStream appelle AVStrMiniPinProcess lorsque de nouvelles données arrivent dans une file d’attente précédemment vide. Consultez Pin-Centric Traitement pour plus d’informations sur les déclencheurs de traitement.
Après le traitement, le minidriver peut empêcher la fin de l’image en clonant le pointeur de flux de bord de pointe. Pour ce faire, appelez KsStreamPointerClone. Consultez pointeurs de flux edge de début et de fin.
Vous pouvez également spécifier un bord de fin distinct en définissant KSPIN_FLAG_DISTINCT_TRAILING_EDGE sur KSPIN_DESCRIPTOR_EX. Une troisième option n’est pas d’avancer le pointeur de flux de bord principal.
La répartition du processus est effectuée au niveau du runtime d’intégration par défaut = PASSIVE_LEVEL, ou éventuellement à DISPATCH_LEVEL si le minidriver a spécifié KSPIN_FLAG_DISPATCH_LEVEL_PROCESSING dans le KSPIN_DESCRIPTOR_EXapproprié.
Cette routine est facultative.
À propos d’AVStrMiniPinConnect
Le minidriver spécifie l’adresse de cette routine dans le membre Connect de sa structure de KSPIN_DISPATCH.
Retourne STATUS_SUCCESS ou l’erreur retournée par la tentative d’établissement d’une connexion intra-connexion. Ne retournez pas STATUS_PENDING.
Cette routine est facultative.
Voir également broches KS.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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 | Bureau |
| d’en-tête | ks.h (include Ks.h) |
| IRQL | (Voir la section Remarques) |