DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO funzione di callback (d3dkmddi.h)

La funzione DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO restituisce il primo descrittore dell'intervallo di frequenza in un oggetto set di intervalli di frequenza di monitoraggio specificato.

Sintassi

DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO DxgkddiMonitorfrequencyrangesetAcquirefirstfrequencyrangeinfo;

NTSTATUS DxgkddiMonitorfrequencyrangesetAcquirefirstfrequencyrangeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORFREQUENCYRANGESET hMonitorFrequencyRangeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_FREQUENCY_RANGE ppFirstMonitorFrequencyRangeInfo
)
{...}

Parametri

[in] hMonitorFrequencyRangeSet

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

[out] ppFirstMonitorFrequencyRangeInfo

Puntatore a una variabile che riceve un puntatore a una struttura D3DKMDT_MONITOR_FREQUENCY_RANGE.

Valore restituito

La funzione pfnAcquireFirstFrequencyRangeInfo restituisce uno dei valori seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha restituito correttamente il primo descrittore dell'intervallo di frequenza.
STATUS_GRAPHICS_DATASET_IS_EMPTY	La funzione ha avuto esito positivo, ma non sono presenti descrittori di intervalli di frequenza nel set.
STATUS_INVALID_PARAMETER	È stato specificato un parametro 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