Condividi tramite

DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET funzione di callback (d3dkmddi.h)

  • Articolo

La funzione pfnGetMonitorFrequencyRangeSet restituisce un handle per l'oggetto set di intervalli di frequenza di monitoraggio associato a un monitoraggio specificato.

Sintassi

DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET DxgkddiMonitorGetmonitorfrequencyrangeset;

NTSTATUS DxgkddiMonitorGetmonitorfrequencyrangeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORFREQUENCYRANGESET phMonitorFrequencyRangeSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORFREQUENCYRANGESET_INTERFACE ppMonitorFrequencyRangeSetInterface
)
{...}

Parametri

[in] hAdapter

Handle che identifica una scheda di visualizzazione. Il sottosistema kernel grafico Microsoft DirectX in precedenza ha fornito questo handle al driver miniport visualizzato nel parametro DxgkInterface della funzione DxgkDdiStartDevice .

[in] VideoPresentTargetId

Intero che identifica una delle destinazioni del video presenti nella scheda di visualizzazione. L'oggetto set di intervalli di frequenza di monitoraggio restituito descrive gli intervalli di frequenza disponibili nel monitoraggio connesso a questo video presente nella destinazione.

[out] phMonitorFrequencyRangeSet

Puntatore a una variabile che riceve un handle per l'oggetto set di intervalli di frequenza di monitoraggio.

[out] ppMonitorFrequencyRangeSetInterface

Puntatore a una variabile che riceve un puntatore a una struttura DXGK_MONITORFREQUENCYRANGESET_INTERFACE . La struttura contiene puntatori a funzioni che il driver miniport visualizzato può chiamare per controllare e modificare l'oggetto set di intervalli di frequenza di monitoraggio.

Valore restituito

La funzione pfnGetMonitorFrequencyRangeSet restituisce uno dei valori seguenti.

Codice restituito Descrizione
STATUS_SUCCESS Funzione completata.
STATUS_INVALID_PARAMETER È stato fornito un parametro non valido.
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER L'handle fornito in hAdapter non è valido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET L'identificatore specificato in VideoPresentTargetId non è valido.
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED Non è presente alcun monitoraggio connesso alla destinazione del video identificata da VideoPresentTargetId.

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

Commenti

Gli identificatori di destinazione VidPN vengono assegnati dal driver miniport visualizzato. LafunzioneDxgkDdiQueryChildRelations, implementata dal driver miniport visualizzato, restituisce una matrice di strutture DXGK_CHILD_DESCRIPTOR, ognuna delle quali contiene un identificatore.

Non è necessario rilasciare l'handle restituito in phMonitorFrequencyRangeSet.

Questa funzione è disponibile anche nell'interfaccia DXGK_MONITOR_INTERFACE_V2 a partire da Windows 7.

Requisiti

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

Vedi anche

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality