Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La funzione pfnGetMonitorFrequencyRangeSet restituisce un handle all'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 della grafica Microsoft DirectX ha fornito in precedenza questo handle al driver miniport visualizzato nella DxgkInterface parametro 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 monitor connesso a questo video di destinazione presente.
[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 alle funzioni che il driver miniport di visualizzazione può chiamare per esaminare 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 | La funzione ha avuto esito positivo. |
| STATUS_INVALID_PARAMETER | È stato specificato 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 monitor connesso alla destinazione del video identificata da VideoPresentTargetId. |
Questa funzione potrebbe restituire anche altri codici di errore definiti in Ntstatus.h.
Osservazioni
Gli identificatori di destinazione VidPN vengono assegnati dal driver miniport di visualizzazione. Il DxgkDdiQueryChildRelationsfunzione, implementato dal driver miniport di visualizzazione, 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |