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

  • Artículo

La función DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO devuelve el primer descriptor de intervalo de frecuencia en un objeto establecido de intervalo de frecuencia de monitor especificado.

Sintaxis

DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO DxgkddiMonitorfrequencyrangesetAcquirefirstfrequencyrangeinfo;

NTSTATUS DxgkddiMonitorfrequencyrangesetAcquirefirstfrequencyrangeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORFREQUENCYRANGESET hMonitorFrequencyRangeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_FREQUENCY_RANGE ppFirstMonitorFrequencyRangeInfo
)
{...}

Parámetros

[in] hMonitorFrequencyRangeSet

Identificador de un objeto de conjunto de intervalos de frecuencia de supervisión. El controlador de minipuerto de pantalla obtuvo previamente este identificador llamando a la función pfnGetMonitorFrequencyRangeSet de la interfaz Monitor.

[out] ppFirstMonitorFrequencyRangeInfo

Puntero a una variable que recibe un puntero a una estructura de D3DKMDT_MONITOR_FREQUENCY_RANGE .

Valor devuelto

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

Código devuelto Descripción
STATUS_SUCCESS La función devolvió correctamente el primer descriptor de intervalo de frecuencia.
STATUS_GRAPHICS_DATASET_IS_EMPTY La función se realizó correctamente, pero no había descriptores de intervalo de frecuencia en el conjunto.
STATUS_INVALID_PARAMETER Se proporcionó un parámetro no válido.
STATUS_INVALID_MONITOR_FREQUENCYRANGESET El identificador proporcionado en hMonitorFrequencyRangeSet no era válido.

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

Comentarios

Cuando haya terminado de usar la estructura D3DKMDT_MONITOR_FREQUENCY_RANGE, debe liberar la estructura llamando a pfnReleaseFrequencyRangeInfo.

Puede obtener todos los descriptores de un intervalo de frecuencia de supervisión establecido llamando a pfnAcquireFirstFrequencyRangeInfo y, a continuación, realizando una secuencia de llamadas a pfnAcquireNextFrequencyRangeInfo.

Requisitos

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