Funzione MFCreateMediaBufferWrapper (mfapi.h)

Articolo
02/28/2024

Crea un buffer multimediale che esegue il wrapping di un buffer multimediale esistente. Il nuovo buffer multimediale punta alla stessa memoria del buffer multimediale originale o a un offset dall'inizio della memoria.

Sintassi

HRESULT MFCreateMediaBufferWrapper(
  [in]  IMFMediaBuffer *pBuffer,
  [in]  DWORD          cbOffset,
  [in]  DWORD          dwLength,
  [out] IMFMediaBuffer **ppBuffer
);

Parametri

[in] pBuffer

Puntatore all'interfaccia FMMediaBuffer del buffer multimediale originale.

[in] cbOffset

Inizio del nuovo buffer, come offset in byte dall'inizio del buffer originale.

[in] dwLength

Dimensioni del nuovo buffer. Il valore di cbOffset + dwLength deve essere minore o uguale alla dimensione dei dati validi del buffer originale. Le dimensioni dei dati validi vengono restituite dal metodo FMMediaBuffer::GetCurrentLength .

[out] ppBuffer

Riceve un puntatore all'interfaccia FMMediaBuffer . Il chiamante deve rilasciare l'interfaccia.

Valore restituito

La funzione restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Funzione completata.
E_INVALIDARG	L'offset richiesto o la lunghezza richiesta non è valida.

Commenti

La dimensione massima del buffer wrapper è limitata alle dimensioni dei dati validi nel buffer originale. Potrebbe essere minore della dimensione allocata del buffer originale. Per impostare le dimensioni dei dati validi, chiamare FMIMediaBuffer::SetCurrentLength.

Questa funzione è 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	mfapi.h
Libreria	Mfplat.lib
DLL	Mfplat.dll

Vedi anche

Buffer multimediali

Funzioni di Media Foundation

Condividi tramite