Condividi tramite


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

Vedi anche

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality