KsPinGetAvailableByteCount-Funktion (ks.h)

Artikel
02/07/2025

Die KsPinGetAvailableByteCount Routine gibt die Anzahl der Byte von Eingabedaten vor dem führenden Rand und die Anzahl der Bytes des Ausgabepuffers vor dem führenden Rand aus, sowohl für die Warteschlange eines vom Aufrufer angegebenen Pins.

Syntax

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

Parameter

[in] Pin

Ein Zeiger auf eine KSPIN- Struktur, für die diese Warteschlangenparameter berechnet werden sollen.

[out, optional] InputDataBytes

Ein Zeiger auf einen LONG-Wert, in dem die Routine die Anzahl der Eingabedatenbytes vor dem führenden Rand zurückgibt. Der Aufrufer wird auf NULL- festgelegt, wenn dieser Wert nicht angefordert wird.

[out, optional] OutputBufferBytes

Ein Zeiger auf einen LONG-Wert, in dem die Routine die Anzahl der Ausgabepufferbytes vor dem führenden Rand zurückgibt. Der Aufrufer wird auf NULL- festgelegt, wenn dieser Wert nicht angefordert wird.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn die angeforderten Anzahl(n) abgerufen wurden. Ein nicht erfolgreicher Rückgabestatus gibt an, dass Pin- keine zugeordnete Warteschlange aufweist.

Bemerkungen

Nicht eingefügte Pins sollten InputDataBytes- für Eingabe-Pins und OutputBufferBytes- für Ausgabe-Pins verwenden.

Die Ergebnisse dieses Anrufs sind nicht garantiert sicher, es sei denn, die Verarbeitungsmutex wird zur Anrufzeit gehalten, oder der Anrufer wurde privat synchronisiert, bevor die Routine aufgerufen wird. Um eine private Synchronisierung durchzuführen, stellen Sie sicher, dass der Pin während der Ausführung der Routine nicht von "Abrufen" zu "Beenden" wechselt. Siehe Processing Mutex in AVStream.

Beachten Sie außerdem, dass die direkte Transformation Eingabe- und Ausgabeanzahlen bereitstellen kann.

In Windows XP und DirectX 8.0 ist die anzahl der InputDataBytes nicht gültig, es sei denn, frames, die der Filter empfängt, sind voll.

Weitere Informationen finden Sie unter Leading and Trailing Edge Stream Pointers.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen.
Zielplattform-	Universal
Header-	ks.h (enthalten Ks.h)
Library	Ks.lib