структура D3DDDIARG_PRESENT1 (d3dumddi.h)

Статья
08/07/2023

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

Синтаксис

typedef struct _D3DDDIARG_PRESENT1 {
  [in] const D3DDDIARG_PRESENTSURFACE *phSrcResources;
  [in] UINT                           SrcResources;
  [in] HANDLE                         hDstResource;
       UINT                           DstSubResourceIndex;
  [in] D3DDDI_PRESENTFLAGS            Flags;
  [in] D3DDDI_FLIPINTERVAL_TYPE       FlipInterval;
       UINT                           Reserved;
  [in] const RECT                     *pDirtyRects;
  [in] UINT                           DirtyRects;
       UINT                           BackBufferMultiplicity;
} D3DDDIARG_PRESENT1;

Члены

[in] phSrcResources

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

[in] SrcResources

Количество исходных ресурсов, которые находятся в массиве, на который указывает phSrcResources.

[in] hDstResource

Дескриптор целевого ресурса для отображения. Если значение РАВНО NULL, назначение неизвестно, и драйвер минипорта дисплея определяет назначение непосредственно перед обработкой потока команд оборудования.

DstSubResourceIndex

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

[in] Flags

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

[in] FlipInterval

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

Reserved

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

[in] pDirtyRects

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

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

[in] DirtyRects

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

BackBufferMultiplicity

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