DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

La funzione pfnGetAdditionalMonitorModeSet restituisce un handle a un oggetto set di modalità di origine del monitoraggio aggiuntivo associato a un monitoraggio specificato. È disponibile nell'interfaccia DXGK_MONITOR_INTERFACE_V2 , a partire da Windows 7.

Sintassi

DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET DxgkddiMonitorGetadditionalmonitormodeset;

NTSTATUS DxgkddiMonitorGetadditionalmonitormodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PUINT pNumberModes,
  [out] DEREF_ECOUNT_PPDXGK_TARGETMODE_DETAIL_TIMING ppAdditionalModesSet
)
{...}

Parametri

[in] hAdapter

Handle che identifica una scheda di visualizzazione. Il sottosistema kernel grafico Microsoft DirectX ha fornito in precedenza questo handle al driver miniport di visualizzazione 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à aggiuntive ppAdditionalModesSet restituito descrive i set di modalità di origine del monitoraggio aggiuntivi disponibili nel monitor connesso a questa destinazione presente nel video.

[out] pNumberModes

Puntatore a una variabile che contiene il numero di modalità di temporizzazione aggiuntive della destinazione del video presente specificata da VideoPresentTargetId.

[out] ppAdditionalModesSet

Puntatore a una variabile che riceve un puntatore a una struttura DXGK_TARGETMODE_DETAIL_TIMING . La struttura descrive le modalità di temporizzazione aggiuntive di un video che sono compatibili con il dispositivo di visualizzazione.

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 monitor connesso alla destinazione del video identificata da VideoPresentTargetId.
STATUS_NOT_FOUND	Impossibile trovare la destinazione del video identificata da VideoPresentTargetId.

Commenti

Gli identificatori di destinazione VidPN vengono assegnati dal driver miniport di visualizzazione. La funzione DxgkDdiQueryChildRelations , implementata dal driver miniport di visualizzazione, restituisce una matrice di strutture DXGK_CHILD_DESCRIPTOR , ognuna delle quali contiene un identificatore.

Questa funzione è disponibile a partire da Windows 7.