DXGKDDI_CREATEDOORBELL funzione di callback (d3dkmddi.h)

Articolo
04/08/2024

Importante

Alcune informazioni si riferiscono a un prodotto in 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.

Il sistema operativo chiama la funzione di callback DxgkDdiCreateDoorbell di KMD 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 relativo 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 un codice di errore.

Commenti

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

La funzione DxgkDdiCreateDoorbell di 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 perdere nel caso in cui UMD non invii mai comandi o inizi a inviare comandi in un secondo momento. In questo modo, i campanelli fisici vengono usati solo quando effettivamente necessario.

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