структура DXGI_DDI_ARG_PRESENT1 (dxgiddi.h)

Статья
02/29/2024

Описывает ресурс для отображения. Используется с функцией pfnPresent1(DXGI) в драйверах отображения windows Display Driver Model (WDDM) 1.3 и более поздних версий.

Синтаксис

typedef struct DXGI_DDI_ARG_PRESENT1 {
  [in] DXGI_DDI_HDEVICE                  hDevice;
  [in] const DXGI_DDI_ARG_PRESENTSURFACE *phSurfacesToPresent;
  [in] UINT                              SurfacesToPresent;
  [in] DXGI_DDI_HRESOURCE                hDstResource;
  [in] UINT                              DstSubResourceIndex;
  [in] void                              *pDXGIContext;
  [in] DXGI_DDI_PRESENT_FLAGS            Flags;
  [in] DXGI_DDI_FLIP_INTERVAL_TYPE       FlipInterval;
       UINT                              Reserved;
  [in] const RECT                        *pDirtyRects;
  [in] UINT                              DirtyRects;
       UINT                              BackBufferMultiplicity;
} DXGI_DDI_ARG_PRESENT1;

Члены

[in] hDevice

Дескриптор устройства отображения (графический контекст), на котором драйвер выполняет презентацию. Среда выполнения Direct3D передает этот дескриптор драйверу в элементе hDrvDeviceструктуры D3D10DDIARG_CREATEDEVICE , когда среда выполнения вызывает функцию CreateDevice(D3D10) драйвера для создания устройства отображения.

[in] phSurfacesToPresent

Массив дескрипторов, отличных от NULL , и отсчитываемых от нуля индексов исходного ресурса для отображения или освобождения. phSurfacesToPresent всегда является допустимым дескриптором для отображения ресурса.

[in] SurfacesToPresent

Массив поверхностей для представления. Не должно быть равно нулю.

[in] hDstResource

Дескриптор целевого ресурса для отображения. hDstResource может иметь значение NULL , если назначение неизвестно; Режим ядра определяет назначение непосредственно перед отправкой аппаратного потока команд через DMA графическому процессору.

При представлении большого количества ресурсов hDstResource будет иметь значение NULL, а драйвер должен преобразовать только последний дескриптор исходного ресурса для использования с функцией pfnPresentCb .

[in] DstSubResourceIndex

Отсчитываемый от нуля индекс целевого ресурса, который указывает дескриптор в элементе hDstResource . Индекс DstSubResourceIndex указывает подресурс или поверхность для отображения.

[in] pDXGIContext

Дескриптор контекста DXGI. Этот дескриптор непрозрачн для драйвера. Драйвер должен передать дескриптор в этом элементе в качестве элемента pDXGIContextструктуры DXGIDDICB_PRESENT , когда драйвер вызывает функцию pfnPresentCbDXGI .

[in] Flags

Структура DXGI_DDI_PRESENT_FLAGS , определяющая в флагах битового поля способ выполнения текущей операции.

[in] FlipInterval

DXGI_DDI_FLIP_INTERVAL_TYPE типизированное значение, указывающее интервал пролистывания (т. е. если пролистывание происходит после нулевой, один, два, три или четыре вертикальные синхронизации).

Reserved

Этот элемент зарезервирован и должен иметь нулевое значение.

[in] pDirtyRects

Указатель на массив грязное прямоугольников (RECT) относительно исходного прямоугольника SrcRect, который указывает на измененную часть плоскости наложения.

Драйвер может использовать этот элемент для оптимизации, хотя он не требуется использовать сведения о прямоугольнике грязное. Однако драйвер никогда не должен завершать вызов функции на основе предоставленных грязное прямоугольников.

[in] DirtyRects

Число грязное прямоугольников в массиве, на который указывает pDirtyRects.

BackBufferMultiplicity

Число физических задних буферов на логическую обратную буфер.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8.1,WDDM 1.3 и более поздних версий
Минимальная версия сервера	Windows Server 2012 R2
Верхняя часть	dxgiddi.h (включая D3d10umddi.h)