Compartir a través de

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

  • Artículo

La función pfnAcquireNextFrequencyRangeInfo devuelve el siguiente descriptor de intervalo de frecuencia en un conjunto de intervalos de frecuencia de monitor, dado el descriptor del intervalo de frecuencia actual.

Sintaxis

DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo;

NTSTATUS DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORFREQUENCYRANGESET hMonitorFrequencyRangeSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_FREQUENCY_RANGE_CONST pMonitorFrequencyRangeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_FREQUENCY_RANGE ppNextMonitorFrequencyRangeInfo
)
{...}

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.

[in] pMonitorFrequencyRangeInfo

Puntero a una estructura D3DKMDT_MONITOR_FREQUENCY_RANGE que es el descriptor de intervalo de frecuencia actual. El controlador de minipuerto de pantalla obtuvo previamente este puntero mediante una llamada a pfnAcquireFirstFrequencyRangeInfo o pfnAcquireNextFrequencyRangeInfo.

[out] ppNextMonitorFrequencyRangeInfo

Puntero a una variable que recibe un puntero a una estructura de D3DKMDT_MONITOR_FREQUENCY_RANGE que es el siguiente descriptor de intervalo de frecuencia.

Valor devuelto

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

Código devuelto Descripción
STATUS_SUCCESS La función devolvió correctamente el siguiente descriptor de intervalo de frecuencia.
STATUS_GRAPHICS_DATASET_IS_EMPTY La función se realizó correctamente, pero no había más descriptores de intervalo de frecuencia en el conjunto.
STATUS_INVALID_PARAMETER Se proporcionó un parámetro no válido.
STATUS_INVALID_FREQUENCYRANGE El descriptor de intervalo de frecuencia proporcionado en pMonitorFrequencyRangeInfo no era 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