IMFASFSplitter::GetNextSample-Methode (wmcontainer.h)

Artikel
08/28/2023

Ruft ein Beispiel aus dem ASF-Splitter (Advanced Systems Format) ab, nachdem die Daten analysiert wurden.

Syntax

HRESULT GetNextSample(
  [out] DWORD     *pdwStatusFlags,
  [out] WORD      *pwStreamNumber,
  [out] IMFSample **ppISample
);

Parameter

[out] pdwStatusFlags

Empfängt einen der folgenden Werte.

Wert	Bedeutung
ASF_STATUSFLAGS_INCOMPLETE	Weitere Beispiele können abgerufen werden. Rufen Sie GetNextSample in einer Schleife auf, bis der pdwStatusFlags-Parameter den Wert null empfängt.
Zero	Es sind keine zusätzlichen Beispiele verfügbar. Rufen Sie IMFASFSplitter::P arseData auf, um dem Splitter weitere Eingabedaten zu geben.

[out] pwStreamNumber

Wenn die Methode ein Beispiel im ppISample-Parameter zurückgibt, empfängt dieser Parameter die Nummer des Datenstroms, zu dem das Beispiel gehört.

[out] ppISample

Empfängt einen Zeiger auf die IMFSample-Schnittstelle des analysierten Beispiels. Der Aufrufer muss die Schnittstelle freigeben. Wenn keine Beispiele bereit sind, empfängt dieser Parameter den Wert NULL.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
MF_E_ASF_INVALIDDATA	Die ASF-Daten im Puffer sind ungültig.
MF_E_ASF_MISSINGDATA	Es gibt eine Lücke in den ASF-Daten.

Hinweise

Rufen Sie vor dem Aufrufen dieser Methode IMFASFSplitter::P arseData auf, um eingabedaten an den Splitter zu übergeben. Wenn die Eingabe nicht genügend Daten für ein vollständiges Beispiel enthält, ist die GetNextSample-Methode erfolgreich, gibt aber NULL im ppISample-Parameter zurück.

Der ASF-Splitter überspringt Beispiele für nicht ausgewählte Streams. Rufen Sie ZUM Auswählen von Streams IMFASFSplitter::SelectStreams auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wmcontainer.h
Bibliothek	Mfuuid.lib

Weitere Informationen

ASF-Splitter

IMFASFSplitter

Freigeben über