Condividi tramite


Metodo IMFMediaSink::GetCharacteristics (mfidl.h)

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. Sono definiti i flag seguenti:

Value Meaning
MEDIASINK_FIXED_STREAMS
0x00000001
Il sink multimediale ha un numero fisso di flussi. Non supporta i metodi IMFMediaSink::AddStreamSink e IMFMediaSink::RemoveStreamSink . Questo flag è un suggerimento per l'applicazione.
MEDIASINK_CANNOT_MATCH_CLOCK
0x00000002
Il sink multimediale non può corrispondere alle frequenze con un clock esterno.

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

Questo flag deve essere usato con moderazione, 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. Utilizza i campioni 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 della presentazione viene impostato chiamando il metodo IMFMediaSink::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 campioni di preroll prima dell'avvio dell'orologio della presentazione. Il sink multimediale espone l'interfaccia IMFMediaSinkPreroll .
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 solo, quelli nella tabella seguente.

Codice restituito Description
S_OK
Il metodo è riuscito.
MF_E_SHUTDOWN
È stato chiamato il metodo Shutdown del sink multimediale.

Osservazioni:

Le caratteristiche di un sink multimediale sono fisse per tutta la durata del sink.

Requisiti

Requisito Value
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Header mfidl.h
Library Mfuuid.lib

Vedere anche

IMFMediaSink

Sink multimediali