Metodo IMFMediaSource::P ause (mfidl.h)

Sospende tutti i flussi attivi nell'origine multimediale.

Sintassi

HRESULT Pause();

Valore restituito

Il metodo restituisce un valore 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_INVALID_STATE_TRANSITION
Transizione di stato non valida. L'origine multimediale deve essere nello stato avviato.
MF_E_SHUTDOWN
È stato chiamato il metodo Shutdown dell'origine multimediale.

Commenti

Questo metodo è asincrono. Al termine dell'operazione, l'origine multimediale invia e l'evento MESourcePaused e ogni flusso attivo invia un evento MEStreamPaused . Se il metodo restituisce un codice di errore, non vengono generati eventi.

L'origine multimediale deve essere nello stato avviato. Il metodo ha esito negativo se l'origine multimediale viene sospesa o arrestata.

Mentre l'origine è sospesa, le chiamate a IMFMediaStream::RequestSample hanno esito positivo, ma i flussi non recapitano campioni fino a quando l'origine non viene avviata di nuovo. Si noti che la coda di eventi di origine non viene serializzata con le code di eventi di flusso, quindi il client potrebbe ricevere alcuni esempi dopo l'evento MESourcePaused , a causa di problemi di multithreading. Tuttavia, il client non riceverà campioni da un flusso dopo l'evento MEStreamPaused .

Non tutte le origini multimediali possono essere sospese. Se un'origine multimediale può essere sospesa, il metodo IMFMediaSource::GetCharacteristics restituisce il flag MFMEDIASOURCE_CAN_PAUSE.

Requisiti

   
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

IMFMediaSource

Origini multimediali