Share via

IAsyncReader::Length-Methode (strmif.h)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die Length -Methode ruft die Gesamtlänge des Datenstroms ab.

Syntax

HRESULT Length(
  LONGLONG *pTotal,
  LONGLONG *pAvailable
);

Parameter

pTotal

Zeiger auf eine Variable, die die Länge des Datenstroms in Bytes empfängt.

pAvailable

Zeiger auf eine Variable, die den derzeit verfügbaren Teil des Datenstroms in Bytes empfängt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
VFW_S_ESTIMATED
 Die zurückgegebenen Werte sind Schätzungen; beispielsweise, wenn die Datei über ein Netzwerk gelesen wird.
E_UNEXPECTED
 Die Datei ist nicht geöffnet oder nicht mehr vorhanden.

Hinweise

Für Datenströme, die über ein Netzwerk abgerufen werden, ist der gesamte Datenstrom zunächst möglicherweise nicht verfügbar. Lesevorgänge, die über die verfügbare Länge hinausgehen, können für einen längeren Zeitraum blockiert werden, bis dieser Teil des Datenstroms verfügbar ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IAsyncReader-Schnittstelle