DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO funzione di callback (d3dkmddi.h)

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