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

  • Artículo

La función pfnAcquireMonitorSourceModeSet devuelve un identificador al objeto establecido del modo de origen de supervisión asociado a un monitor especificado.

Sintaxis

DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET DxgkddiMonitorAcquiremonitorsourcemodeset;

NTSTATUS DxgkddiMonitorAcquiremonitorsourcemodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORSOURCEMODESET phMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORSOURCEMODESET_INTERFACE ppMonitorSourceModeSetInterface
)
{...}

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 minipuerto de pantalla en el parámetro DxgkInterface de la función DxgkDdiStartDevice .

[in] VideoPresentTargetId

Entero que identifica uno de los destinos de presentación de vídeo en el adaptador de pantalla. El objeto set de modo de origen devuelto describe los modos disponibles en el monitor que está conectado a este destino de vídeo presente.

[out] phMonitorSourceModeSet

Puntero a una variable que recibe un identificador de un objeto establecido en modo de origen de supervisión.

[out] ppMonitorSourceModeSetInterface

Puntero a una variable que recibe un puntero a una estructura DXGK_MONITORSOURCEMODESET_INTERFACE . La estructura contiene punteros a funciones a las que el controlador de minipuerto de pantalla puede llamar para inspeccionar y modificar el objeto establecido del modo de origen del monitor.

Valor devuelto

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

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.

Esta función también puede devolver otros códigos de error definidos en Ntstatus.h.

Comentarios

El controlador de minipuerto de pantalla 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.

Cuando haya terminado de usar el identificador de objeto set del modo de origen del monitor, debe liberar el identificador llamando a pfnReleaseMonitorSourceModeSet. Se hace referencia a los objetos del conjunto de modo de destino, por lo que si adquiere un identificador varias veces, debe liberarlo ese mismo número de veces.

Esta función también está disponible en la interfaz DXGK_MONITOR_INTERFACE_V2 a partir de Windows 7.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Plataforma de destino Escritorio
Encabezado d3dkmddi.h (incluya D3dkmddi.h)
IRQL PASSIVE_LEVEL

Consulte también

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality