Metodo IDXGIOutput1::GetDisplaySurfaceData1 (dxgi1_2.h)

Copia la superficie di visualizzazione (buffer anteriore) in una risorsa fornita dall'utente.

Sintassi

HRESULT GetDisplaySurfaceData1(
  [in] IDXGIResource *pDestination
);

Parametri

[in] pDestination

Puntatore a un'interfaccia di risorsa che rappresenta la risorsa a cui GetDisplaySurfaceData1 copia l'area di visualizzazione.

Valore restituito

Restituisce uno dei codici di errore descritti nell'argomento DXGI_ERROR .

Commenti

GetDisplaySurfaceData1 è simile a IDXGIOutput::GetDisplaySurfaceData, ad eccezione di GetDisplaySurfaceData1 accetta un IDXGIResource e IDXGIOutput::GetDisplaySurfaceData accetta un IDXGISurface.

GetDisplaySurfaceData1 restituisce un errore se la risorsa di input non è una trama 2D (rappresentata dall'interfaccia ID3D11Texture2D ) con una dimensione della matrice (membro ArraySize della struttura D3D11_TEXTURE2D_DESC ) uguale ai buffer della catena di scambio.

L'IDXGIOutput originale::GetDisplaySurfaceData e l'aggiornamento di GetDisplaySurfaceData1 si comportano esattamente allo stesso modo. GetDisplaySurfaceData1 è stato richiesto perché le trame con dimensioni della matrice uguali a 2 (ArraySize = 2) non implementano IDXGISurface.

È possibile chiamare GetDisplaySurfaceData1 solo quando un output è in modalità schermo intero. Se GetDisplaySurfaceData1 ha esito positivo, riempie la risorsa di destinazione.

Usare IDXGIOutput::GetDesc per determinare le dimensioni (larghezza e altezza) dell'output quando si vuole allocare spazio per la risorsa di destinazione. Ciò è vero indipendentemente dalla rotazione del monitoraggio di destinazione. Una risorsa di destinazione creata da un componente grafico (ad esempio Direct3D 11) deve essere creata con l'autorizzazione di scrittura della CPU (vedere D3D11_CPU_ACCESS_WRITE). È possibile creare altre superfici con l'autorizzazione di lettura scrittura della CPU (D3D11_CPU_ACCESS_READ D3D11_CPU_ACCESS_WRITE | ). GetDisplaySurfaceData1 modifica i dati di superficie per adattare la risorsa di destinazione (stretch, shrink, convert format, ruota). GetDisplaySurfaceData1 esegue l'estensione e la compattazione con il campionamento dei punti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 e Aggiornamento della piattaforma per Windows 7 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 e Aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	dxgi1_2.h
Libreria	DXGI.lib

Vedi anche

IDXGIOutput1