KsPinGetLeadingEdgeStreamPointer, fonction (ks.h)

Article
02/26/2024

La fonction KsPinGetLeadingEdgeStreamPointer acquiert le pointeur de flux de bord de pointe pour la file d’attente associée à l’épingle 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 bord de pointe doit être acquis.

[in] State

Ce paramètre spécifie comment acquérir le pointeur de flux de bord de pointe. Il peut s'agir d'une des méthodes suivantes :

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 d’accès aux données associées au pointeur ne peut être effectuée tant que le pointeur n’est pas 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 de pointe. Si aucune trame de données n’est associée au pointeur de flux, retournez la valeur 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 retournée

KsPinGetLeadingEdgeStreamPointer retourne un pointeur vers une structure KSSTREAM_POINTER ou NULL. Une valeur de retour null peut se produire car aucune file d’attente n’est associée à la broche, ce qui indique que la broche n’utilise pas le mécanisme de transport standard. Une valeur de retour NULL peut également se produire en raison de l’échec d’une tentative de verrouillage du bord d’avant, indiquant qu’aucune trame de données n’est associée à l’arête d’avant.

Remarques

Les filtres qui implémentent le traitement centré sur les broches appellent souvent KsPinGetLeadingEdgeStreamPointer.

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	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib
IRQL	<=DISPATCH_LEVEL