DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET funzione di callback (d3dkmddi.h)
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 |