DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET función de devolución de llamada (d3dkmddi.h)
La función pfnGetMonitorFrequencyRangeSet devuelve un identificador al objeto de conjunto de intervalos de frecuencia de supervisión asociado a un monitor especificado.
Sintaxis
DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET DxgkddiMonitorGetmonitorfrequencyrangeset;
NTSTATUS DxgkddiMonitorGetmonitorfrequencyrangeset(
[in] IN_CONST_D3DKMDT_ADAPTER hAdapter,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
[out] OUT_PD3DKMDT_HMONITORFREQUENCYRANGESET phMonitorFrequencyRangeSet,
[out] DEREF_OUT_CONST_PPDXGK_MONITORFREQUENCYRANGESET_INTERFACE ppMonitorFrequencyRangeSetInterface
)
{...}
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 intervalos de frecuencias de supervisión devuelto describe los intervalos de frecuencia disponibles en el monitor que está conectado a este destino de vídeo presente.
[out] phMonitorFrequencyRangeSet
Puntero a una variable que recibe un identificador para el objeto de conjunto de intervalos de frecuencia de supervisión.
[out] ppMonitorFrequencyRangeSetInterface
Puntero a una variable que recibe un puntero a una estructura DXGK_MONITORFREQUENCYRANGESET_INTERFACE . La estructura contiene punteros a funciones a las que el controlador de miniporte de pantalla puede llamar para inspeccionar y modificar el objeto de conjunto de intervalos de frecuencia de supervisión.
Valor devuelto
La función pfnGetMonitorFrequencyRangeSet devuelve uno de los siguientes valores.
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | La función se ha realizado correctamente. |
| STATUS_INVALID_PARAMETER | Se proporcionó un parámetro no válido. |
| 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 visualización asigna identificadores de destino VidPN. LafunciónDxgkDdiQueryChildRelations, 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.
No es necesario liberar el identificador devuelto en phMonitorFrequencyRangeSet.
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 (incluye D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |