DXGKDDI_SETTIMINGSFROMVIDPN funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

DXGKDDI_SETTIMINGSFROMVIDPN viene chiamato per impostare o modificare i tempi di visualizzazione in un adattatore. Questa DDI sostituisce DxgkDdiCommitVidPn.

Sintassi

DXGKDDI_SETTIMINGSFROMVIDPN DxgkddiSettimingsfromvidpn;

NTSTATUS DxgkddiSettimingsfromvidpn(
  [in]      IN_CONST_HANDLE hAdapter,
  [in, out] IN_OUT_PDXGKARG_SETTIMINGSFROMVIDPN pSetTimings
)
{...}

Parametri

[in] hAdapter

Identifica l'adattatore su cui devono essere impostati i tempi di visualizzazione.

[in, out] pSetTimings

Puntatore a una struttura DXGKARG_SETTIMINGSFROMVIDPN che descrive i tempi di visualizzazione da impostare.

Valore restituito

Se la routine ha esito positivo, restituisce STATUS_SUCCESS.

Nota Il driver deve restituire sempre un codice di esito positivo a meno che non si verifichi un errore nei parametri o un errore durante l'elaborazione della richiesta. Se il driver non è in grado di impostare uno o più percorsi come richiesto, deve descrivere la condizione usando i campi di output, ma segnala comunque l'esito positivo.

Osservazioni

Il driver in modalità kernel valuta i parametri e avvia le modifiche se nessuna condizione ne impedisce il tentativo. Se condizioni come il superamento delle limitazioni della larghezza di banda di destinazione impediscono l'esecuzione delle modifiche, il driver deve descrivere le condizioni. Se la modifica dei tempi sarebbe possibile, ma richiede prima di tutto il lavoro di preparazione, il driver dovrebbe indicare che nei flag di output.

Questa funzione viene sempre chiamata a livello PASSIVE.

Questa funzione è registrata da DriverEntry del driver miniport di visualizzazione.

A partire da WDDM 2.6, quando la sincronizzazione della visualizzazione è disponibile e deve essere abilitata più di una visualizzazione, il sistema operativo indicherà che gli schermi devono essere sincronizzati nella chiamata DXGKDDI_SETTIMINGSFROMVIDPN. Ogni percorso da sincronizzare avrà un valore diverso da zero nel campo SyncLockGroup bit e lo stile di sincronizzazione selezionato nel campo SyncLockStyle, entrambi inclusi nella struttura DXGK_SET_TIMING_PATH_INFO.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Condividi tramite