estrutura D3DDDIARG_PRESENT1 (d3dumddi.h)

Artigo
02/23/2024

Descreve um recurso a ser exibido. Usado com a função pfnPresent1(D3D) pelo WDDM (Modelo de Driver de Exibição do Windows) 1.3 e drivers de exibição do modo de usuário posterior.

Sintaxe

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;

Membros

[in] phSrcResources

Uma matriz de identificadores não NULL e índices baseados em zero para o recurso de origem a ser exibido ou liberado. phSrcResources é sempre um identificador válido para exibição de um recurso.

[in] SrcResources

O número de recursos de origem que estão na matriz apontada por phSrcResources.

[in] hDstResource

Um identificador para o recurso de destino para o qual exibir. Se FOR NULL, o destino será desconhecido e o driver de miniporto de exibição determinará o destino logo antes do fluxo de comandos de hardware ser processado.

DstSubResourceIndex

[in] O índice baseado em zero no recurso de destino, que é especificado pelo identificador no membro hDstResource . Esse índice indica o sub-recurso ou superfície para o qual exibir.

[in] Flags

Uma estrutura D3DDDI_PRESENTFLAGS que identifica, em sinalizadores de campo de bits, como exibir.

[in] FlipInterval

Um valor de tipo D3DDDI_FLIPINTERVAL_TYPE que indica o intervalo de inversão (ou seja, se a inversão ocorrer após zero, um, dois, três ou quatro sincronizações verticais).

Reserved

Esse membro é reservado e deve ser definido como zero.

[in] pDirtyRects

Um ponteiro para uma matriz de retângulos sujo (RECTs), em relação ao retângulo de origem SrcRect, que indica a parte do plano de sobreposição que foi alterada.

O driver pode usar esse membro para executar otimizações, embora não seja necessário usar as informações do retângulo sujo. No entanto, o driver nunca deve falhar em uma chamada de função com base nos retângulos sujo fornecidos.

[in] DirtyRects

O número de retângulos sujo na matriz apontada por pDirtyRects.

BackBufferMultiplicity

O número de buffer de fundo físico por buffer de fundo lógico.