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 visualizzato ottenuto in precedenza questo handle chiamando la funzione pfnGetMonitorFrequencyRangeSetdell'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 |