Metodo IMFSample::GetBufferByIndex (mfobjects.h)
Ottiene un buffer dall'esempio in base all'indice.
Nota Nella maggior parte dei casi, è più sicuro usare il metodo IMFSample::ConvertToContiguousBuffer . Se l'esempio contiene più buffer, il metodo ConvertToContiguousBuffer li sostituisce con un singolo buffer, copia i dati originali in tale buffer e restituisce il nuovo buffer al chiamante. L'operazione di copia si verifica al massimo una volta. Nelle chiamate successive non viene copiato alcun dato.
Sintassi
HRESULT GetBufferByIndex(
[in] DWORD dwIndex,
[out] IMFMediaBuffer **ppBuffer
);
Parametri
[in] dwIndex
Indice del buffer. Per trovare il numero di buffer nell'esempio, chiamare FMSample::GetBufferCount. I buffer vengono indicizzati da zero.
[out] ppBuffer
Riceve un puntatore all'interfaccia FMMediaBuffer . Il chiamante deve rilasciare l'interfaccia.
Valore restituito
Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
Argomento puntatore NULL o l'indice non è compreso nell'intervallo. |
Commenti
Un esempio può contenere più buffer. Usare il metodo GetBufferByIndex per enumerare i singoli buffer.
Questa interfaccia è disponibile nelle piattaforme seguenti se i componenti ridistribuibili di Windows Media Format 11 SDK sono installati:
- Windows XP con Service Pack 2 (SP2) e versioni successive.
- Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | mfobjects.h (include Mfidl.h) |
| Libreria | Mfuuid.lib |