Metodo IDXGIOutput::GetDisplaySurfaceData (dxgi.h)

[A partire da Direct3D 11.1, è consigliabile non usare più GetDisplaySurfaceData per recuperare la superficie di visualizzazione corrente. Usare invece IDXGIOutput1::GetDisplaySurfaceData1, che supporta la modalità di visualizzazione stereo.]

Ottiene una copia della superficie di visualizzazione corrente.

Sintassi

HRESULT GetDisplaySurfaceData(
  [in] IDXGISurface *pDestination
);

Parametri

[in] pDestination

Tipo: IDXGISurface*

Puntatore a una superficie di destinazione (vedere IDXGISurface).

Valore restituito

Tipo: HRESULT

Restituisce uno dei valori DXGI_ERROR .

Commenti

IDXGIOutput::GetDisplaySurfaceData può essere chiamato solo quando un output è in modalità a schermo intero. Se il metodo ha esito positivo, DXGI riempie la superficie di destinazione.

Usare IDXGIOutput::GetDesc per determinare le dimensioni (larghezza e altezza) dell'output quando si vuole allocare spazio per la superficie di destinazione. Ciò vale indipendentemente dalla rotazione del monitoraggio di destinazione. È necessario creare una superficie di destinazione creata da un componente grafico (ad esempio Direct3D 10) con l'autorizzazione di scrittura della CPU (vedere D3D10_CPU_ACCESS_WRITE). È necessario creare altre superfici con l'autorizzazione di lettura/scrittura della CPU (vedere D3D10_CPU_ACCESS_READ_WRITE). Questo metodo modificherà i dati della superficie in modo che si adattino alla superficie di destinazione (estensione, compattazione, formato di conversione, rotazione). L'estensione e la compattazione vengono eseguite con il campionamento dei punti.

Requisiti

Piattaforma di destinazione	Windows
Intestazione	dxgi.h
Libreria	DXGI.lib

Vedi anche

Interfacce DXGI

IDXGIOutput