Condividi tramite


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
S_OK
Il metodo è riuscito.
E_INVALIDARG
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

Vedi anche

FMISample

FMSample::ConvertToContiguousBuffer

Esempi multimediali