Metodo IMFMediaSession::Start (mfidl.h)

  • Articolo

Avvia la sessione multimediale.

Sintassi

HRESULT Start(
  [in] const GUID        *pguidTimeFormat,
  [in] const PROPVARIANT *pvarStartPosition
);

Parametri

[in] pguidTimeFormat

Puntatore a un GUID che specifica il formato ora per il parametro pvarStartPosition . Questo parametro può essere NULL. Il valore NULL equivale al passaggio di GUID_NULL.

I GUID di formato ora seguenti sono definiti:

Valore Significato
GUID_NULL
 Ora di presentazione. Il parametro pvarStartPosition deve avere uno dei tipi PROPVARIANT seguenti.
  • VT_I8: il parametro pvarStartPosition contiene la posizione iniziale in 100-nanosecondi, rispetto all'inizio della presentazione.
  • VT_EMPTY: la riproduzione inizia dalla posizione corrente.
Tutte le origini multimediali supportano questo formato di tempo.
MF_TIME_FORMAT_SEGMENT_OFFSET
 Offset segmento. Questo formato ora è supportato dall'origine sequencer. L'ora iniziale è un offset all'interno di un segmento.

Chiamare la funzione MFCreateSequencerSegmentOffset per creare il valore PROPVARIANT per il parametro pvarStartPosition .
MF_TIME_FORMAT_ENTRY_RELATIVE
Nota Richiede Windows 7 o versione successiva.
 
Passare a una voce di playlist. Il parametro pvarStartPosition specifica l'indice della voce della playlist, rispetto alla voce corrente. Ad esempio, il valore 2 ignora due voci. Per ignorare l'indietro, passare un valore negativo. Il tipo PROPVARIANT è VT_I4.

Se un'origine multimediale supporta questo formato di tempo, il metodo IMFMediaSource::GetCharacteristics restituisce uno o entrambi i flag seguenti:

  • MFMEDIASOURCE_CAN_SKIPFORWARD
  • MFMEDIASOURCE_CAN_SKIPBACKWARD

[in] pvarStartPosition

Puntatore a un PROPVARIANT che specifica la posizione iniziale per la riproduzione. Il significato e il tipo di dati di questo parametro sono indicati dal parametro pguidTimeFormat .

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_INVALIDREQUEST
 Impossibile eseguire l'operazione nello stato corrente della sessione multimediale.
MF_E_SHUTDOWN
 La sessione multimediale è stata arrestata.

Commenti

Quando viene chiamato questo metodo, la sessione multimediale avvia l'orologio della presentazione e inizia a elaborare esempi multimediali.

Questo metodo è asincrono. Al termine del metodo, la sessione multimediale invia un evento MESessionStarted .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mfidl.h
Libreria Mfuuid.lib

Vedi anche

FMIMediaSession