IAsyncReader::Length-Methode (strmif.h)
[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 |
|---|---|
|
Erfolg. |
|
Die zurückgegebenen Werte sind Schätzungen; beispielsweise, wenn die Datei über ein Netzwerk gelesen wird. |
|
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 |