estrutura D3DDDIARG_PRESENT1 (d3dumddi.h)

Artigo
02/06/2025

Descreve um recurso a ser exibido. Usado com a função pfnPresent1(D3D) pelo WDDM (Windows Display Driver Model) 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 deNULL não e índices baseados em zero no recurso de origem a ser exibido ou liberado. phSrcResources é sempre um identificador válido para um recurso a ser exibido.

[in] SrcResources

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

[in] hDstResource

Um identificador para o recurso de destino para o qual exibir. Se NULL, o destino será desconhecido e o driver de miniporto de exibição determinará o destino pouco 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 a sub-fonte ou superfície para a qual exibir.

[in] Flags

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

[in] FlipInterval

Um valor digitado D3DDDI_FLIPINTERVAL_TYPEque indica o intervalo de inversão (ou seja, se a inversão ocorrer após zero, uma, duas, 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 sujos (de RECT), em relação ao retângulo de origem SrcRect, que indicam 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 de retângulo sujo. No entanto, o driver nunca deve falhar em uma chamada de função com base nos retângulos sujos fornecidos.

[in] DirtyRects

O número de retângulos sujos na matriz apontado por pDirtyRects.

BackBufferMultiplicity

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