DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET funzione di callback (d3dkmddi.h)
La funzione pfnAcquireMonitorSourceModeSet restituisce un handle all'oggetto set di modalità di origine di monitoraggio associato a un monitoraggio specificato.
Sintassi
DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET DxgkddiMonitorAcquiremonitorsourcemodeset;
NTSTATUS DxgkddiMonitorAcquiremonitorsourcemodeset(
[in] IN_CONST_D3DKMDT_ADAPTER hAdapter,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
[out] OUT_PD3DKMDT_HMONITORSOURCEMODESET phMonitorSourceModeSet,
[out] DEREF_OUT_CONST_PPDXGK_MONITORSOURCEMODESET_INTERFACE ppMonitorSourceModeSetInterface
)
{...}
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 modalità di origine restituita descrive le modalità disponibili nel monitor connesso a questo video presente nella destinazione.
[out] phMonitorSourceModeSet
Puntatore a una variabile che riceve un handle per un oggetto set di modalità di origine di monitoraggio.
[out] ppMonitorSourceModeSetInterface
Puntatore a una variabile che riceve un puntatore a una struttura DXGK_MONITORSOURCEMODESET_INTERFACE . La struttura contiene puntatori a funzioni che il driver miniport visualizzato può chiamare per controllare e modificare l'oggetto set di modalità di origine del monitoraggio.
Valore restituito
La funzione pfnAcquireMonitorSourceModeSet restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | Funzione completata. |
| 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. La funzione DxgkDdiQueryChildRelations , implementata dal driver miniport visualizzato, restituisce una matrice di strutture DXGK_CHILD_DESCRIPTOR , ognuna delle quali contiene un identificatore.
Al termine dell'uso dell'handle dell'oggetto set di modalità di origine del monitoraggio, è necessario rilasciare l'handle chiamando pfnReleaseMonitorSourceModeSet. Gli oggetti set di modalità di destinazione vengono conteggiati, quindi, se si acquisisce un handle più volte, è necessario rilasciarlo con lo stesso numero di volte.
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 |