DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO funzione di callback (d3dkmddi.h)

Articolo
2025-02-06

Il pfnAcquirePreferredModeInfo restituisce un descrittore della modalità preferita in un oggetto set di modalità di origine del monitoraggio specificato.

Sintassi

DXGKDDI_MONITORSOURCEMODESET_ACQUIREPREFERREDMODEINFO DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo;

NTSTATUS DxgkddiMonitorsourcemodesetAcquirepreferredmodeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORSOURCEMODESET hMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_SOURCE_MODE ppFirstMonitorSourceModeInfo
)
{...}

Parametri

[in] hMonitorSourceModeSet

Handle per un oggetto set in modalità di origine del monitoraggio. Il driver miniport di visualizzazione ottenuto in precedenza questo handle chiamando la funzione pfnAcquireMonitorSourceModeSet dell'interfaccia Monitor.

[out] ppFirstMonitorSourceModeInfo

Puntatore a una variabile che riceve un puntatore a una struttura D3DKMDT_MONITOR_SOURCE_MODE. La struttura contiene un'ampia gamma di informazioni sulla modalità di origine del monitor preferita, tra cui l'ID e il segnale video.

Valore restituito

La funzione pfnAcquirePreferredModeInfo restituisce uno dei valori seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha restituito correttamente un descrittore della modalità preferita.
STATIS_GRAPHICS_NO_PREFERRED_MODE	La funzione ha avuto esito positivo, ma il set di modalità di origine del monitoraggio specificato non dispone di una modalità preferita.
STATUS_GRAPHICS_INVALID_MONITOR_SOURCEMODESET	L'handle fornito in hMonitorSourceModeSet non è valido.

Osservazioni

Al termine dell'uso della struttura di D3DKMDT_MONITOR_SOURCE_MODE, è necessario rilasciare la struttura chiamando pfnReleaseModeInfo.

Il tipo di dati D3DKMDT_HMONITORSOURCEMODESET è definito in D3dkmdt.h.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
piattaforma di destinazione	Desktop
intestazione	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Condividi tramite