DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET función de devolución de llamada (d3dkmddi.h)

Artículo
02/23/2024

La función pfnGetAdditionalMonitorModeSet devuelve un identificador a un objeto de conjunto de modo de origen de monitor adicional asociado a un monitor especificado. Está disponible en la interfaz DXGK_MONITOR_INTERFACE_V2 , a partir de Windows 7.

Sintaxis

DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET DxgkddiMonitorGetadditionalmonitormodeset;

NTSTATUS DxgkddiMonitorGetadditionalmonitormodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PUINT pNumberModes,
  [out] DEREF_ECOUNT_PPDXGK_TARGETMODE_DETAIL_TIMING ppAdditionalModesSet
)
{...}

Parámetros

[in] hAdapter

Identificador que identifica un adaptador de pantalla. El subsistema del kernel de gráficos de Microsoft DirectX proporcionó anteriormente este identificador al controlador de miniporte para mostrar en el parámetro DxgkInterface de la función DxgkDdiStartDevice .

[in] VideoPresentTargetId

Entero que identifica uno de los destinos presentes de vídeo en el adaptador de pantalla. El objeto de conjunto de modos adicionales ppAdditionalModesSet devuelto describe los conjuntos de modos de origen de monitor adicionales que están disponibles en el monitor que está conectado a este destino de vídeo presente.

[out] pNumberModes

Puntero a una variable que contiene el número de modos de control de tiempo adicionales del destino actual del vídeo especificado por VideoPresentTargetId.

[out] ppAdditionalModesSet

Puntero a una variable que recibe un puntero a una estructura de DXGK_TARGETMODE_DETAIL_TIMING . La estructura describe los modos de control de tiempo adicionales de un vídeo que son compatibles con el dispositivo de visualización.

Valor devuelto

La función pfnAcquireMonitorSourceModeSet devuelve uno de los siguientes valores.

Código devuelto	Descripción
STATUS_SUCCESS	La función se ha realizado correctamente.
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER	El identificador proporcionado en hAdapter no era válido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	El identificador proporcionado en VideoPresentTargetId no era válido.
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED	No hay ningún monitor conectado al destino de vídeo presente identificado por VideoPresentTargetId.
STATUS_NOT_FOUND	No se encontró el destino del vídeo presente identificado por VideoPresentTargetId.

Comentarios

El controlador de minipuerto de visualización asigna identificadores de destino VidPN. La función DxgkDdiQueryChildRelations , implementada por el controlador de miniporte de pantalla, devuelve una matriz de estructuras de DXGK_CHILD_DESCRIPTOR , cada una de las cuales contiene un identificador.

Esta función está disponible a partir de Windows 7.