Condividi tramite


Interfaccia FMSample (mfobjects.h)

Rappresenta un esempio di supporto, ovvero un oggetto contenitore per i dati multimediali. Per il video, un esempio contiene in genere un fotogramma video. Per i dati audio, un esempio contiene in genere più esempi audio, anziché un singolo esempio di audio.

Un esempio multimediale contiene zero o più buffer. Ogni buffer gestisce un blocco di memoria ed è rappresentato dall'interfaccia FMIMediaBuffer . Un esempio può avere più buffer. I buffer vengono mantenuti in un elenco ordinato e accessibili in base al valore dell'indice. È anche valido avere un esempio vuoto senza buffer.

Ereditarietà

L'interfaccia FMSample eredita da FMAttributes. FmiSample include anche questi tipi di membri:

Metodi

L'interfaccia FMSample include questi metodi.

 
IMFSample::AddBuffer

Aggiunge un buffer alla fine dell'elenco di buffer nell'esempio.
FMSample::ConvertToContiguousBuffer

Converte un esempio con più buffer in un esempio con un singolo buffer.
FMISample::CopyToBuffer

Copia i dati di esempio in un buffer. Questo metodo concatena i dati validi da tutti i buffer dell'esempio, in ordine.
IMFSample::GetBufferByIndex

Ottiene un buffer dall'esempio in base all'indice.
IMFSample::GetBufferCount

Recupera il numero di buffer nell'esempio.
FMSample::GetSampleDuration

Recupera la durata dell'esempio.
FMSample::GetSampleFlags

Recupera i flag associati all'esempio. Attualmente non sono definiti flag.
IMFSample::GetSampleTime

Recupera l'ora di presentazione dell'esempio.
FMSample::GetTotalLength

Recupera la lunghezza totale dei dati validi in tutti i buffer dell'esempio. La lunghezza viene calcolata come somma dei valori recuperati dal metodo FMMediaBuffer::GetCurrentLength.
FMISample::RemoveAllBuffers

Rimuove tutti i buffer dall'esempio.
IMFSample::RemoveBufferByIndex

Rimuove un buffer in corrispondenza di un indice specificato dall'esempio.
FMSample::SetSampleDuration

Imposta la durata dell'esempio.
FMSample::SetSampleFlags

Imposta i flag associati all'esempio. Attualmente non sono definiti flag.
IMFSample::SetSampleTime

Imposta l'ora di presentazione dell'esempio.

Commenti

Per creare un nuovo esempio multimediale, chiamare MFCreateSample.

Nota  

Quando si chiama CopyAllItems, ereditato dall'interfaccia FMAttributes , in un fmiSample, l'ora di esempio, la durata e i flag non vengono copiati nell'esempio di destinazione. È necessario copiare questi valori nel nuovo esempio manualmente.

 
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)

Vedi anche

FMAttributes

Interfacce di Media Foundation

Esempi multimediali

Attributi di esempio