KsPinGetAvailableByteCount, fonction (ks.h)

Article
05/23/2024

La routine KsPinGetAvailableByteCount génère le nombre d’octets de données d’entrée devant le bord de pointe et le nombre d’octets de mémoire tampon de sortie devant le bord de pointe, à 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 pointe. 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 d’entrée. L’appelant définit la valeur NULL si cette valeur n’est pas demandée.

Valeur retournée

Retourne STATUS_SUCCESS si les nombres demandés ont été récupérés. Un retour infructueux status indique que Pin n’a pas de file d’attente associée.

Remarques

Les broches non 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 sécurisés, sauf si le mutex de traitement est conservé au moment de l’appel ou si l’appelant a été synchronisé en privé avant d’appeler la routine. Pour la synchronisation privée, assurez-vous que le code pin ne passe pas de l’acquisition à l’arrêt pendant l’exécution de la routine. Consultez Traitement de 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 que le filtre reçoit sont pleines.

Pour plus d’informations, consultez Pointeurs de bord de début et de fin Stream.

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