DXGKDDI_CONNECTDOORBELL funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

Importante

Alcune informazioni riguardano un prodotto in versione preliminare che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non fornisce alcuna garanzia, espressa o implicita, in relazione alle informazioni fornite qui.

DxgkDdiConnectDoorbell si connette (o riconnette) un oggetto porta creato in precedenza a una coda hardware.

Sintassi

DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;

NTSTATUS DxgkddiConnectdoorbell(
  INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}

Parametri

pArgs

[in/out] Puntatore a una struttura DXGKARG_CONNECTDOORBELL che descrive il campanello da connettere.

Valore restituito

DxgkDdiConnectDoorbell restituisce STATUS_SUCCESS se kmD è riuscito a connettere correttamente il proprio campanello alla coda hardware specificata. Questa chiamata non dovrebbe in genere avere esito negativo; Tuttavia, un codice di errore restituito sarebbe da GPU perso o arrestato tipi di scenari irrecuperabili.

Osservazioni

Quando UMD chiama D3DKMTConnectDoorbell, il sistema operativo chiama DxgkDdiConnectDoorbell in modo che il KMD possa eseguire le operazioni seguenti:

Specificare un indirizzo virtuale della CPU mappato alla posizione del campanello fisico.
Stabilire le connessioni necessarie tra l'oggetto coda hardware, l'oggetto campanello, l'indirizzo fisico del campanello, l'utilità di pianificazione GPU e così via.

Al ritorno da questa DDI, kmd deve considerare questo indirizzo fisico come riservato per questa particolare coda hardware. Tuttavia, il sistema operativo non ha un requisito di univocità per l'indirizzo fisico del campanello. Ovvero, kmd può scegliere di condividere lo stesso indirizzo fisico con più campanelli logici/code hardware a seconda dell'implementazione hardware. Ad esempio, alcuni hardware potrebbero scegliere di assegnare lo stesso indirizzo fisico a tutte le code hardware di un singolo contesto hardware. È anche possibile che più campanelli logici condividono la stessa pagina fisica da 4 KB, ma usano un offset univoco all'interno della pagina.

Per altre informazioni, vedere invio di lavoro in modalità utente.