KsPinGetLeadingEdgeStreamPointer, fonction (ks.h)

Article
02/07/2025

La fonction KsPinGetLeadingEdgeStreamPointer acquiert le pointeur de flux de périphérie de pointe pour la file d’attente associée à la broche donnée.

Syntaxe

KSDDKAPI PKSSTREAM_POINTER KsPinGetLeadingEdgeStreamPointer(
  [in] PKSPIN                 Pin,
  [in] KSSTREAM_POINTER_STATE State
);

Paramètres

[in] Pin

Pointeur vers la structure KSPIN propriétaire de la file d’attente pour laquelle le pointeur de flux de périphérie de pointe doit être acquis.

[in] State

Ce paramètre spécifie comment acquérir le pointeur de flux de périphérie de pointe. Il peut s’agir de l’un des éléments suivants :

KSSTREAM_POINTER_STATE_UNLOCKED

Acquérir le pointeur de flux de périphérie de pointe, qu’il référence ou non une trame de données.

Aucune tentative ne peut être effectuée pour accéder à toutes les données associées au pointeur jusqu’à ce que le pointeur soit verrouillé. Notez également que les images associées à un pointeur de flux déverrouillé peuvent être annulées.

KSSTREAM_POINTER_STATE_LOCKED

Acquérir et verrouiller le pointeur de flux de bord principal. Si aucune trame de données n’est associée au pointeur de flux, retournez NULL. Si un pointeur nonnull est retourné, il s’agit d’un pointeur de flux verrouillé et d’une trame de données associée. Les images associées à un pointeur de flux verrouillé ne peuvent pas être annulées.

Valeur de retour

KsPinGetLeadingEdgeStreamPointer retourne un pointeur vers une structure KSSTREAM_POINTER ou NULL. Une valeur de retour de NULL peut se produire, car aucune file d’attente n’est associée à la broche, indiquant que la broche n’utilise pas le mécanisme de transport standard. Par ailleurs, une valeur de retour de NULL peut se produire, car une tentative de verrouillage du bord de début a échoué, indiquant qu’il n’existe aucune trame de données associée au bord de début.

Remarques

Les filtres qui implémentent Pin-Centric traitement appellent souvent KsPinGetLeadingEdgeStreamPointer.

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	Universel
d’en-tête	ks.h (include Ks.h)
bibliothèque	Ks.lib
IRQL	<=DISPATCH_LEVEL