IMFASFSplitter::GetNextSample-Methode (wmcontainer.h)

  • Artikel

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