DXGKDDI_CONNECTDOORBELL funzione di callback (d3dkmddi.h)

Articolo
05/23/2024

Importante

Alcune informazioni si riferiscono a un prodotto di versione preliminare che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

DxgkDdiConnectDoorbell si connette (o riconnettersi) a un oggetto doorbell creato in precedenza in 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 è stato in grado di connettere correttamente l'oggetto doorbell alla coda hardware specificata. Questa chiamata non deve in genere non riuscire; tuttavia, un codice di errore restituito sarebbe da GPU perso o arrestato tipi di scenari irrecuperabili.

Commenti

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.
Creare le connessioni necessarie tra l'oggetto coda hardware, l'oggettodoorbell, l'indirizzo fisico della porta, l'utilità di pianificazione GPU e così via.

Al ritorno da questo DDI, il 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 4 KB, ma usano un offset univoco all'interno della pagina.

Per altre informazioni, vedere Invio in modalità utente.