DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO funzione di callback (d3dkmddi.h)

Articolo
02/25/2024

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 visualizzato ottenuto in precedenza questo handle chiamando la funzione pfnGetMonitorFrequencyRangeSet 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 visualizzato ha ottenuto in precedenza 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 più descrittori dell'intervallo di frequenza nel set.
STATUS_INVALID_PARAMETER	È stato fornito 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 anche restituire altri codici di errore definiti in Ntstatus.h.

Commenti

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.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Piattaforma di destinazione	Desktop
Intestazione	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Condividi tramite