estrutura DXGI_DDI_ARG_PRESENT1 (dxgiddi.h)

Descreve um recurso a ser exibido. Usado com a função pfnPresent1(DXGI) 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 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;

Membros

[in] hDevice

Um identificador para o dispositivo de exibição (contexto gráfico) no qual o driver executa a apresentação. O runtime do Direct3D passa esse identificador para o driver no membro hDrvDevice da estrutura D3D10DDIARG_CREATEDEVICE quando o runtime chama a função CreateDevice(D3D10) do driver para criar o dispositivo de exibição.

[in] phSurfacesToPresent

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

[in] SurfacesToPresent

A matriz de superfícies a serem apresentadas. Não deve ser zero.

[in] hDstResource

Um identificador para o recurso de destino para o qual exibir. hDstResource poderá ser NULL se o destino for desconhecido; O modo kernel determinará o destino pouco antes de enviar o fluxo de comando de hardware por meio do DMA para o processador de gráficos.

Quando muitos recursos estiverem sendo apresentados, hDstResource será NULL e o driver só deverá traduzir o último identificador de recurso de origem para uso com a função pfnPresentCb .

[in] DstSubResourceIndex

O índice baseado em zero no recurso de destino, que o identificador no membro hDstResource especifica. O índice DstSubResourceIndex indica a sub-fonte ou superfície para a qual exibir.

[in] pDXGIContext

Um identificador para o contexto DXGI. Esse identificador é opaco para o driver. O driver deve passar o identificador nesse membro como o membro pDXGIContext da estrutura DXGIDDICB_PRESENT quando o driver chama a função pfnPresentCbDXGI .

[in] Flags

Uma estrutura DXGI_DDI_PRESENT_FLAGS que identifica, em sinalizadores de campo de bit, como executar a operação atual.

[in] FlipInterval

Um valor de tipo DXGI_DDI_FLIP_INTERVAL_TYPE que 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 sujo (RECTs), em relação ao SrcRect do retângulo de origem, 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 back físico por buffer de back lógico.

Requisitos

Confira também

CreateDevice(D3D10)

DXGIDDICB_PRESENT

DXGI_DDI_FLIP_INTERVAL_TYPE

DXGI_DDI_PRESENT_FLAGS

RECT

pfnPresent1(DXGI)

pfnPresentCb

pfnPresentCbDXGI