DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET funzione di callback (d3dkmddi.h)
La funzione pfnGetMonitorDescriptorSet restituisce un handle a un oggetto set di descrittori di monitoraggio associato a un monitoraggio specificato.
Sintassi
DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET DxgkddiMonitorGetmonitordescriptorset;
NTSTATUS DxgkddiMonitorGetmonitordescriptorset(
[in] IN_CONST_D3DKMDT_ADAPTER hAdapter,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
[out] OUT_PD3DKMDT_HMONITORDESCRIPTORSET phMonitorDescriptorSet,
[out] DEREF_OUT_CONST_PPDXGK_MONITORDESCRIPTORSET_INTERFACE ppMonitorDescriptorSetInterface
)
{...}
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 descrittori di monitoraggio restituito contiene descrittori per il monitoraggio connesso a questo video presente nella destinazione.
[out] phMonitorDescriptorSet
Puntatore a una variabile che riceve un handle per un oggetto set di descrittori di monitoraggio.
[out] ppMonitorDescriptorSetInterface
Puntatore a una variabile che riceve un puntatore a una struttura DXGK_MONITORDESCRIPTORSET_INTERFACE . La struttura contiene puntatori a funzioni che il driver miniport visualizzato può chiamare per controllare e modificare l'oggetto set di descrittori di monitoraggio.
Valore restituito
La funzione pfnGetMonitorDescriptorSet 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. |
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.
Non è necessario rilasciare l'handle restituito in phMonitorDescriptorSet.
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 |