estructura DXGI_DDI_ARG_PRESENT1 (dxgiddi.h)

Artículo
08/07/2023

Describe un recurso que se va a mostrar. Se usa con la función pfnPresent1(DXGI) de Windows Display Driver Model (WDDM) 1.3 y controladores de pantalla en modo usuario posteriores.

Sintaxis

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;

Miembros

[in] hDevice

Identificador del dispositivo de visualización (contexto de gráficos) en el que el controlador realiza la presentación. El tiempo de ejecución de Direct3D pasa este identificador al controlador en el miembro hDrvDevice de la estructura D3D10DDIARG_CREATEDEVICE cuando el tiempo de ejecución llama a la función CreateDevice(D3D10) del controlador para crear el dispositivo para mostrar.

[in] phSurfacesToPresent

Matriz de identificadores que no son NULL e índices basados en cero en el recurso de origen para mostrar o liberar. phSurfacesToPresent siempre es un identificador válido para que se muestre un recurso.

[in] SurfacesToPresent

Matriz de superficies que se van a presentar. No debe ser cero.

[in] hDstResource

Identificador del recurso de destino al que se va a mostrar. hDstResource puede ser NULL si se desconoce el destino; el modo kernel determinará el destino justo antes de enviar el flujo de comandos de hardware a través de DMA al procesador de gráficos.

Cuando se presentan muchos recursos, hDstResource será NULL y el controlador solo debe traducir el último identificador de recursos de origen para su uso con la función pfnPresentCb .

[in] DstSubResourceIndex

Índice de base cero en el recurso de destino, que especifica el identificador del miembro hDstResource . El índice DstSubResourceIndex indica el subrecurso o la superficie en la que se va a mostrar.

[in] pDXGIContext

Identificador del contexto DXGI. Este identificador es opaco para el controlador. El controlador debe pasar el identificador en este miembro como miembro pDXGIContext de la estructura DXGIDDICB_PRESENT cuando el controlador llama a la función pfnPresentCbDXGI .

[in] Flags

Estructura DXGI_DDI_PRESENT_FLAGS que identifica, en marcas de campo de bits, cómo realizar la operación actual.

[in] FlipInterval

Valor con tipo DXGI_DDI_FLIP_INTERVAL_TYPE que indica el intervalo de volteo (es decir, si el volteo se produce después de cero, uno, dos, tres o cuatro sincronizaciones verticales).

Reserved

Este miembro está reservado y debe establecerse en cero.

[in] pDirtyRects

Puntero a una matriz de rectángulos sucios (RECTs), en relación con el rectángulo de origen SrcRect, que indica la parte del plano de superposición que ha cambiado.

El controlador puede usar este miembro para realizar optimizaciones, aunque no es necesario usar la información de rectángulo sucio. Sin embargo, el controlador nunca debe producir un error en una llamada de función basada en los rectángulos sucios proporcionados.

[in] DirtyRects

Número de rectángulos sucios en la matriz a los que apunta pDirtyRects.

BackBufferMultiplicity

Número de búferes de reserva físicos por búfer de retroceso lógico.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1, WDDM 1.3 y versiones posteriores
Servidor mínimo compatible	Windows Server 2012 R2
Encabezado	dxgiddi.h (incluya D3d10umddi.h)