KsPinGetAvailableByteCount, fonction (ks.h)

Article
02/07/2025

Le KsPinGetAvailableByteCount routine génère le nombre d’octets de données d’entrée devant le bord de début et le nombre d’octets de mémoire tampon de sortie devant le bord principal, à la fois pour la file d’attente d’une broche spécifiée par l’appelant.

Syntaxe

KSDDKAPI NTSTATUS KsPinGetAvailableByteCount(
  [in]            PKSPIN Pin,
  [out, optional] PLONG  InputDataBytes,
  [out, optional] PLONG  OutputBufferBytes
);

Paramètres

[in] Pin

Pointeur vers une structure KSPIN pour laquelle calculer ces paramètres de file d’attente.

[out, optional] InputDataBytes

Pointeur vers une valeur LONG dans laquelle la routine retourne le nombre d’octets de données d’entrée devant le bord de début. L’appelant définit la valeur NULL si cette valeur n’est pas demandée.

[out, optional] OutputBufferBytes

Pointeur vers une valeur LONG dans laquelle la routine retourne le nombre d’octets de mémoire tampon de sortie devant le bord de début. L’appelant définit la valeur NULL si cette valeur n’est pas demandée.

Valeur de retour

Retourne STATUS_SUCCESS si le ou les nombres demandés ont été récupérés. Un état de retour non réussi indique que épingler n’a pas de file d’attente associée.

Remarques

Les broches non déplacées doivent utiliser InputDataBytes pour les broches d’entrée et OutputBufferBytes pour les broches de sortie.

Les résultats de cet appel ne sont pas garantis comme sécurisés, sauf si le mutex de traitement est conservé au moment de l’appel, ou si l’appelant est synchronisé en privé avant d’appeler la routine. Pour synchroniser privé, assurez-vous que la broche ne passe pas de l’acquisition à l’arrêt pendant l’exécution de la routine. Consultez Traitement du mutex dans AVStream.

Notez également que la transformation sur place peut fournir des nombres d’entrées et de sorties.

Dans Windows XP et DirectX 8.0, le nombre InputDataBytes n’est pas valide, sauf si les images reçues par le filtre sont complètes.

Pour plus d’informations, consultez pointeurs de flux edge de début et de fin.

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