estructura DXGK_MULTIPLANE_OVERLAY_PLANE3 (d3dkmddi.h)

Especifica un plano de superposición que se va a mostrar en una llamada a la función DxgkDdiSetVidPnSourceAddressWithMultiPlaneOverlay3 .

Sintaxis

typedef struct _DXGK_MULTIPLANE_OVERLAY_PLANE3 {
  UINT                                LayerIndex;
  ULONGLONG                           PresentId;
  DXGK_PLANE_SPECIFIC_INPUT_FLAGS     InputFlags;
  DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS    OutputFlags;
  UINT                                MaxImmediateFlipLine;
  UINT                                ContextCount;
  DXGK_PRIMARYCONTEXTDATA             **ppContextData;
  UINT                                DriverPrivateDataSize;
  PVOID                               pDriverPrivateData;
  DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 PlaneAttributes;
} DXGK_MULTIPLANE_OVERLAY_PLANE3;

Miembros

LayerIndex

Índice de base cero del plano de superposición que se va a mostrar. El plano superior (en la dirección z) tiene el índice cero. Los valores de índice de los planos deben ser secuenciales de arriba a abajo.

PresentId

Identificador de 64 bits por plano utilizado por el controlador para notificar la finalización del comando de superposición.

InputFlags

Estructura DXGK_PLANE_SPECIFIC_INPUT_FLAGS que identifica las operaciones de presentación específicas del plano que se van a realizar.

OutputFlags

Estructura DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS que contiene el estado devuelto por el controlador.

MaxImmediateFlipLine

Línea de presentación que delimita si se debe promover un volteo VSYNC a un volteo inmediato, donde la línea 0 corresponde al primer píxel activo del marco. Este valor se omite para volteos que no son VSYNC.

Este valor es -1 cuando no se desea la promoción de un VSYNC voltear a un volteo inmediato. En este caso, el volteo siempre esperará a la siguiente VSYNC.

Para un valor distinto de -1, el controlador debe promover este cambio a un volteo inmediato si el HW aún no ha empezado a leer desde la línea de visualización especificada. Los valores de 0 se pueden promover a volteos inmediatos si el HW tiene registros de bloqueo temporal para el marco de presentación actual, pero aún no ha empezado a examinar el primer píxel activo.

El valor de línea de presentación es relativo al modo físico establecido. Si la pantalla está realizando el escalado, la línea de presentación es relativa al tamaño después de aplicar el escalado.

Cuando se promueve un volteo de VSYNC a un volteo inmediato, el controlador debe establecer DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS. FlipConvertedToImmediate a TRUE.

ContextCount

Número de contextos de la matriz que especifica el miembro Context.

ppContextData

Matriz de identificadores de los contextos que han contribuido a una operación de visualización.

DriverPrivateDataSize

Tamaño de los datos del controlador privado.

pDriverPrivateData

Datos del controlador privado.

PlaneAttributes

Estructura de tipo DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 que especifica los atributos del plano de superposición.

Requisitos