IMFSample::GetBufferByIndex-Methode (mfobjects.h)
Ruft einen Puffer aus dem Beispiel nach Index ab.
Hinweis In den meisten Fällen ist es sicherer, die IMFSample::ConvertToContiguousBuffer-Methode zu verwenden. Wenn das Beispiel mehr als einen Puffer enthält, ersetzt die ConvertToContiguousBuffer-Methode diese durch einen einzelnen Puffer, kopiert die ursprünglichen Daten in diesen Puffer und gibt den neuen Puffer an den Aufrufer zurück. Der Kopiervorgang erfolgt höchstens einmal. Bei nachfolgenden Aufrufen werden keine Daten kopiert.
Syntax
HRESULT GetBufferByIndex(
[in] DWORD dwIndex,
[out] IMFMediaBuffer **ppBuffer
);
Parameter
[in] dwIndex
Index des Puffers. Um die Anzahl der Puffer im Beispiel zu ermitteln, rufen Sie IMFSample::GetBufferCount auf. Puffer werden von null indiziert.
[out] ppBuffer
Empfängt einen Zeiger auf die IMFMediaBuffer-Schnittstelle . Der Aufrufer muss die Schnittstelle freigeben.
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
NULL-Zeigerargument, oder der Index liegt außerhalb des Bereichs. |
Hinweise
Ein Beispiel kann mehr als einen Puffer enthalten. Verwenden Sie die GetBufferByIndex-Methode , um die einzelnen Puffer aufzulisten.
Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:
- Windows XP mit Service Pack 2 (SP2) und höher.
- Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition vom Oktober 2006) installiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mfobjects.h (include Mfidl.h) |
| Bibliothek | Mfuuid.lib |