Condividi tramite


Metodo IVMRImagePresenter::StartPresenting (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il StartPresenting metodo viene chiamato subito prima dell'avvio della riproduzione del video. Il relatore allocatore deve eseguire qualsiasi configurazione necessaria in questo metodo.

Sintassi

HRESULT StartPresenting(
  [in] DWORD_PTR dwUserID
);

Parametri

[in] dwUserID

Un cookie di DWORD_PTR definito dall'applicazione che identifica in modo univoco questa istanza di VMR da usare negli scenari in cui un'istanza del relatore allocatore viene usata con più istanze di VMR.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, viene restituito un codice di errore.

Commenti

PresentImage può essere chiamato quando il filtro è in esecuzione o in uno stato sospeso. StartPresenting e StopPresenting possono essere chiamati solo in uno stato di esecuzione. Pertanto, se il grafico viene sospeso prima dell'esecuzione, PresentImage verrà chiamato prima StartPresentingdi .

Requisiti

Requisito Valore
Client minimo supportato Windows XP con SP1 [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Interfaccia IVMRImagePresenter

IVMRImagePresenter::StopPresenting

Uso del renderer di missaggio video