estructura D3DDDIARG_PRESENT1 (d3dumddi.h)

Artículo
02/23/2024

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

Sintaxis

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;

Miembros

[in] phSrcResources

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

[in] SrcResources

Número de recursos de origen a los que apunta phSrcResources en la matriz.

[in] hDstResource

Identificador del recurso de destino al que se va a mostrar. Si es NULL, el destino es desconocido y el controlador de miniporte de pantalla determina el destino justo antes de que se procese el flujo de comandos de hardware.

DstSubResourceIndex

[in] Índice de base cero en el recurso de destino, especificado por el identificador en el miembro hDstResource . Este índice indica el subrecurso o la superficie a la que se va a mostrar.

[in] Flags

Estructura D3DDDI_PRESENTFLAGS que identifica, en marcas de campo de bits, cómo mostrar.

[in] FlipInterval

Valor con tipo D3DDDI_FLIPINTERVAL_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.