Metodo IMFMediaSession::Start (mfidl.h)

Articolo
03/05/2024

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

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