Metodo IMFMediaSink::GetCharacteristics (mfidl.h)

  • Articolo

Ottiene le caratteristiche del sink multimediale.

Sintassi

HRESULT GetCharacteristics(
  [out] DWORD *pdwCharacteristics
);

Parametri

[out] pdwCharacteristics

Riceve un OR bit per bit pari a zero o più flag. I flag seguenti sono definiti:

Valore Significato
MEDIASINK_FIXED_STREAMS
0x00000001
 Il sink multimediale ha un numero fisso di flussi. Non supporta i metodi IMFMediaSink::AddStreamSink e FMMediaSink::RemoveStreamSink. Questo flag è un hint per l'applicazione.
MEDIASINK_CANNOT_MATCH_CLOCK
0x00000002
 Il sink multimediale non può corrispondere alle tariffe con un orologio esterno.

Per ottenere risultati ottimali, questo sink multimediale deve essere usato come origine temporale per l'orologio della presentazione. Se viene usata un'altra origine temporale, il sink multimediale non può corrispondere alle tariffe dell'orologio, con risultati scarsi (ad esempio, glitching).

Questo flag deve essere usato in modo limitato, perché limita la modalità di configurazione della pipeline.

Per altre informazioni sull'orologio della presentazione, vedere Orologio presentazione.
MEDIASINK_RATELESS
0x00000004
 Il sink multimediale è senza frequenza. Usa esempi il più rapidamente possibile e non si sincronizza con un orologio di presentazione.

La maggior parte dei sink di archiviazione è senza frequenza.
MEDIASINK_CLOCK_REQUIRED
0x00000008
 Il sink multimediale richiede un orologio di presentazione. L'orologio di presentazione viene impostato chiamando il metodo FMMediaSink::SetPresentationClock del sink multimediale.

Questo flag è obsoleto, perché tutti i sink multimediali devono supportare il metodo SetPresentationClock , anche se il sink multimediale ignora l'orologio (come in un sink multimediale senza frequenza).
MEDIASINK_CAN_PREROLL
0x00000010
 Il sink multimediale può accettare esempi di preroll prima dell'avvio dell'orologio della presentazione. Il sink multimediale espone l'interfaccia FMMediaSinkPreroll .
MEDIASINK_REQUIRE_REFERENCE_MEDIATYPE
0x00000020
 Il primo sink di flusso (indice 0) è un flusso di riferimento. Il flusso di riferimento deve avere un tipo di supporto prima che i tipi di supporti possano essere impostati negli altri sink di flusso.

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.
MF_E_SHUTDOWN
 Il metodo Shutdown del sink multimediale è stato chiamato.

Commenti

Le caratteristiche di un sink multimediale sono fisse durante il tempo di vita del sink.

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 mfidl.h
Libreria Mfuuid.lib

Vedi anche

FMMediaSink

Sink multimediali