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
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 8.1, WDDM 1.3 e posterior |
Servidor mínimo com suporte | Windows Server 2012 R2 |
Cabeçalho | dxgiddi.h (inclua D3d10umddi.h) |