Метод IDXGIOutput::GetDisplaySurfaceData (dxgi.h)

Статья
08/23/2023

[Начиная с Direct3D 11.1, мы рекомендуем больше не использовать GetDisplaySurfaceData для получения текущей области отображения. Вместо этого используйте IDXGIOutput1::GetDisplaySurfaceData1, который поддерживает режим стереоэкрана.]

Возвращает копию текущей области отображения.

Синтаксис

HRESULT GetDisplaySurfaceData(
  [in] IDXGISurface *pDestination
);

Параметры

[in] pDestination

Тип: IDXGISurface*

Указатель на целевую поверхность (см. IDXGISurface).

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

Тип: HRESULT

Возвращает одно из DXGI_ERROR значений.

IDXGIOutput::GetDisplaySurfaceData можно вызывать только в том случае, если выходные данные в полноэкранном режиме. Если метод завершается успешно, DXGI заполняет целевую поверхность.

Используйте IDXGIOutput::GetDesc , чтобы определить размер (ширину и высоту) выходных данных, если требуется выделить место для целевой поверхности. Это верно независимо от смены целевого монитора. Целевая поверхность, созданная графическим компонентом (например, Direct3D 10), должна быть создана с разрешением на запись ЦП (см. D3D10_CPU_ACCESS_WRITE). Другие поверхности должны создаваться с разрешением на чтение и запись ЦП (см. D3D10_CPU_ACCESS_READ_WRITE). Этот метод изменяет данные поверхности в соответствии с целевой поверхностью (растяжение, сжатие, преобразование формата, поворот). Растяжение и сжатие выполняется с помощью точечной выборки.

Требования


Целевая платформа	Windows
Header	dxgi.h
Библиотека	DXGI.lib

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

Интерфейсы DXGI

IDXGIOutput