estructura DXGI_DDI_ARG_PRESENT1 (dxgiddi.h)
Describe un recurso que se va a mostrar. Se usa con la función pfnPresent1(DXGI) de Windows Display Driver Model (WDDM) 1.3 y controladores de pantalla en modo usuario posteriores.
Sintaxis
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;
Miembros
[in] hDevice
Identificador del dispositivo de visualización (contexto de gráficos) en el que el controlador realiza la presentación. El tiempo de ejecución de Direct3D pasa este identificador al controlador en el miembro hDrvDevice de la estructura D3D10DDIARG_CREATEDEVICE cuando el tiempo de ejecución llama a la función CreateDevice(D3D10) del controlador para crear el dispositivo para mostrar.
[in] phSurfacesToPresent
Matriz de identificadores que no son NULL e índices basados en cero en el recurso de origen para mostrar o liberar. phSurfacesToPresent siempre es un identificador válido para que se muestre un recurso.
[in] SurfacesToPresent
Matriz de superficies que se van a presentar. No debe ser cero.
[in] hDstResource
Identificador del recurso de destino al que se va a mostrar. hDstResource puede ser NULL si se desconoce el destino; el modo kernel determinará el destino justo antes de enviar el flujo de comandos de hardware a través de DMA al procesador de gráficos.
Cuando se presentan muchos recursos, hDstResource será NULL y el controlador solo debe traducir el último identificador de recursos de origen para su uso con la función pfnPresentCb .
[in] DstSubResourceIndex
Índice de base cero en el recurso de destino, que especifica el identificador del miembro hDstResource . El índice DstSubResourceIndex indica el subrecurso o la superficie en la que se va a mostrar.
[in] pDXGIContext
Identificador del contexto DXGI. Este identificador es opaco para el controlador. El controlador debe pasar el identificador en este miembro como miembro pDXGIContext de la estructura DXGIDDICB_PRESENT cuando el controlador llama a la función pfnPresentCbDXGI .
[in] Flags
Estructura DXGI_DDI_PRESENT_FLAGS que identifica, en marcas de campo de bits, cómo realizar la operación actual.
[in] FlipInterval
Valor con tipo DXGI_DDI_FLIP_INTERVAL_TYPE que indica el intervalo de volteo (es decir, si el volteo se produce después de cero, uno, dos, tres o cuatro sincronizaciones verticales).
Reserved
Este miembro está reservado y debe establecerse en cero.
[in] pDirtyRects
Puntero a una matriz de rectángulos sucios (RECTs), en relación con el rectángulo de origen SrcRect, que indica la parte del plano de superposición que ha cambiado.
El controlador puede usar este miembro para realizar optimizaciones, aunque no es necesario usar la información de rectángulo sucio. Sin embargo, el controlador nunca debe producir un error en una llamada de función basada en los rectángulos sucios proporcionados.
[in] DirtyRects
Número de rectángulos sucios en la matriz a los que apunta pDirtyRects.
BackBufferMultiplicity
Número de búferes de reserva físicos por búfer de retroceso lógico.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8.1, WDDM 1.3 y versiones posteriores |
| Servidor mínimo compatible | Windows Server 2012 R2 |
| Encabezado | dxgiddi.h (incluya D3d10umddi.h) |