DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

La funzione pfnAcquireNextFrequencyRangeInfo restituisce il descrittore dell'intervallo di frequenza successivo in un set di intervalli di frequenza di monitoraggio, dato il descrittore dell'intervallo di frequenza corrente.

Sintassi

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
)
{...}

Parametri

[in] hMonitorFrequencyRangeSet

Handle per un oggetto set di intervalli di frequenza di monitoraggio. Il driver miniport di visualizzazione ottenuto in precedenza questo handle chiamando il pfnGetMonitorFrequencyRangeSet funzione dell'interfaccia di monitoraggio .

[in] pMonitorFrequencyRangeInfo

Puntatore a una struttura D3DKMDT_MONITOR_FREQUENCY_RANGE che rappresenta il descrittore dell'intervallo di frequenza corrente. Il driver miniport di visualizzazione precedentemente ottenuto questo puntatore chiamando pfnAcquireFirstFrequencyRangeInfo o pfnAcquireNextFrequencyRangeInfo.

[out] ppNextMonitorFrequencyRangeInfo

Puntatore a una variabile che riceve un puntatore a una struttura D3DKMDT_MONITOR_FREQUENCY_RANGE che rappresenta il descrittore dell'intervallo di frequenza successivo.

Valore restituito

La funzione pfnAcquireNextFrequencyRangeInfo restituisce uno dei valori seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha restituito correttamente il descrittore dell'intervallo di frequenza successivo.
STATUS_GRAPHICS_DATASET_IS_EMPTY	La funzione ha avuto esito positivo, ma non sono presenti altri descrittori di intervalli di frequenza nel set.
STATUS_INVALID_PARAMETER	È stato specificato un parametro non valido.
STATUS_INVALID_FREQUENCYRANGE	Il descrittore dell'intervallo di frequenza fornito in pMonitorFrequencyRangeInfo non è valido.
STATUS_INVALID_MONITOR_FREQUENCYRANGESET	L'handle fornito in hMonitorFrequencyRangeSet non è valido.

Questa funzione potrebbe restituire anche altri codici di errore definiti in Ntstatus.h.

Osservazioni

Al termine dell'uso della struttura D3DKMDT_MONITOR_FREQUENCY_RANGE, è necessario rilasciare la struttura chiamando pfnReleaseFrequencyRangeInfo.

È possibile ottenere tutti i descrittori in un intervallo di frequenza di monitoraggio impostato chiamando pfnAcquireFirstFrequencyRangeInfo e quindi eseguendo una sequenza di chiamate a pfnAcquireNextFrequencyRangeInfo.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
piattaforma di destinazione	Desktop
intestazione	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Condividi tramite