DXGKDDI_CREATEDOORBELL 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.

Il sistema operativo chiama il DxgkDdiCreateDoorbell funzione di callback per creare un campanello per una coda hardware.

Sintassi

DXGKDDI_CREATEDOORBELL DxgkddiCreatedoorbell;

NTSTATUS DxgkddiCreatedoorbell(
  INOUT_PDXGKARG_CREATEDOORBELL pArgs
)
{...}

Parametri

pArgs

[in/out] Puntatore a una struttura DXGKARG_CREATEDOORBELL che descrive il campanello.

Valore restituito

DxgkDdiCreateDoorbell restituisce STATUS_SUCCESS se kmD è riuscito a creare correttamente il suo oggetto porta per la coda hardware specificata e UMD può usare questo campanello per l'invio di lavoro. In caso contrario, restituisce un codice di errore NTSTATUS appropriato. UMD non può usare il campanello per l'invio di lavoro se kmd restituisce codice di errore.

Osservazioni

Quando UMD chiama D3DKMTCreateDoorbell per creare un campanello per una coda hardware, il sistema operativo crea un DxgkDdiCreateDoorbell chiamata a KMD in modo che kmD possa inizializzare le sue strutture del campanello.

La funzione DxgkDdiCreateDoorbell kmD deve creare e inizializzare solo le strutture di dati del campanello. Non deve assegnare una posizione del campanello fisico a questo oggetto campanello, ma come avviene durante una chiamata successiva a DxgkDdiConnectDoorbell. Questa assegnazione differita garantisce che un campanello fisico non venga usato durante la creazione della coda hardware e del campanello, ma solo per sprecare nel caso in cui UMD non invii mai comandi o avvii l'invio di comandi in un secondo momento. In questo modo, i campanelli fisici vengono usati solo quando effettivamente richiesto.

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