Metodo IDDrawExclModeVideo::SetDDrawSurface (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il SetDDrawSurface metodo specifica la superficie DirectDraw da usare nel disegno successivo.

Sintassi

HRESULT SetDDrawSurface(
  [in] IDirectDrawSurface *pDDrawSurface
);

Parametri

[in] pDDrawSurface

Puntatore all'interfaccia IDirectDrawSurface sulla superficie da usare.

Valore restituito

Restituisce un valore HRESULT che dipende dall'implementazione dell'interfaccia.

I valori restituiti dell'implementazione di DirectShow correnti includono quanto segue.

Valore restituito Descrizione
S_OK
Operazione completata.
E_INVALIDARG
L'argomento non è valido.
Codice di errore DirectDraw
Si verifica un errore DirectDraw durante il tentativo di impostare la superficie specificata nel mixer di sovrapposizione.

Commenti

Un'applicazione di gioco può usare questa opzione per condividere la superficie DirectDraw con il filtro Overlay Mixer in modo che il video possa essere disegnato in una superficie specificata. Questa superficie deve essere associata all'oggetto specificato in IDDrawExclModeVideo::SetDDrawObject.

Requisiti

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

Vedi anche

Codici errore e esito positivo

Interfaccia IDDrawExclModeVideo