Condividi tramite


Metodo IDDrawExclModeVideo::GetDDrawSurface (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 GetDDrawSurface metodo recupera la superficie DirectDraw usata da Overlay Mixer.

Sintassi

HRESULT GetDDrawSurface(
  [out] IDirectDrawSurface **ppDDrawSurface,
  [out] BOOL               *pbUsingExternal
);

Parametri

[out] ppDDrawSurface

Indirizzo di un puntatore all'interfaccia IDirectDrawSurface usata da Overlay Mixer.

[out] pbUsingExternal

Puntatore a una variabile che riceve un valore booleano. Riceve il valore TRUE se il Mixer sovrimpressione usa un'area DirectDraw specificata da IDDrawExclModeVideo::SetDDrawSurface o FALSE in caso contrario.

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice 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

Se il grafico del filtro non ha impostato una superficie DirectDraw e il Mixer sovrapposizione non ne ha ancora allocato uno, pDDrawSurface verrà impostato su NULL e pdUsingExternal verrà impostato su FALSE.

Requisiti

   
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