Partilhar via


estrutura DXGI_DDI_ARG_PRESENT1 (dxgiddi.h)

Descreve um recurso a ser exibido. Usado com a função pfnPresent1(DXGI) pelo WDDM (Windows Display Driver Model) 1.3 e posteriores drivers de exibição no modo de usuário.

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 essa alça para o driver no hDrvDevice membro 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 deNULL não e índices baseados em zero no recurso de origem a ser exibido ou liberado. phSurfacesToPresent é sempre um identificador válido para exibição de um recurso.

[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 podem 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 deve converter apenas 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 neste membro como membro pDXGIContext membro 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 digitado DXGI_DDI_FLIP_INTERVAL_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.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 8.1, WDDM 1.3 e posterior
servidor com suporte mínimo Windows Server 2012 R2
cabeçalho dxgiddi.h (inclua D3d10umddi.h)

Consulte também

CreateDevice(D3D10)

DXGIDDICB_PRESENT

DXGI_DDI_FLIP_INTERVAL_TYPE

DXGI_DDI_PRESENT_FLAGS

RECT

pfnPresent1(DXGI)

pfnPresentCb

pfnPresentCbDXGI