Метод IDXGIOutput1::GetDisplaySurfaceData1 (dxgi1_2.h)

Статья
08/23/2023

Копирует поверхность дисплея (передний буфер) в предоставленный пользователем ресурс.

Синтаксис

HRESULT GetDisplaySurfaceData1(
  [in] IDXGIResource *pDestination
);

Параметры

[in] pDestination

Указатель на интерфейс ресурса, представляющий ресурс, в который GetDisplaySurfaceData1 копирует поверхность отображения.

Возвращаемое значение

Возвращает один из кодов ошибок, описанных в разделе DXGI_ERROR .

GetDisplaySurfaceData1 возвращает ошибку, если входной ресурс не является двухмерной текстурой (представленной интерфейсом ID3D11Texture2D ) с размером массива (элемент ArraySizeструктуры D3D11_TEXTURE2D_DESC ), равным буферам цепочки буферов.

Исходный IDXGIOutput::GetDisplaySurfaceData и обновленный GetDisplaySurfaceData1 ведут себя точно так же. Метод GetDisplaySurfaceData1 был обязательным, так как текстуры с размером массива, равным 2 (ArraySize = 2), не реализуют IDXGISurface.

Метод GetDisplaySurfaceData1 можно вызывать только в полноэкранном режиме. Если getDisplaySurfaceData1 завершается успешно, он заполняет целевой ресурс.

Используйте IDXGIOutput::GetDesc , чтобы определить размер (ширину и высоту) выходных данных, если требуется выделить место для целевого ресурса. Это верно независимо от смены целевого монитора. Целевой ресурс, созданный графическим компонентом (например, Direct3D 11), должен быть создан с разрешением на запись ЦП (см. D3D11_CPU_ACCESS_WRITE). Другие поверхности можно создавать с разрешением на чтение и запись ЦП (D3D11_CPU_ACCESS_READ | D3D11_CPU_ACCESS_WRITE). GetDisplaySurfaceData1 изменяет данные surface в соответствии с целевым ресурсом (растяжение, сжатие, преобразование формата, поворот). GetDisplaySurfaceData1 выполняет растяжение и сжатие с выборкой точек.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 и обновление платформы для Windows 7 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	dxgi1_2.h
Библиотека	DXGI.lib

См. также раздел

IDXGIOutput1