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

La funzione DxgkDdiDisconnectDoorbell disconnette un campanello connesso in precedenza da una coda hardware.

Sintassi

DXGKDDI_DISCONNECTDOORBELL DxgkddiDisconnectdoorbell;

NTSTATUS DxgkddiDisconnectdoorbell(
  INOUT_PDXGKARG_DISCONNECTDOORBELL pArgs
)
{...}

Parametri

pArgs

[in/out] Puntatore a una struttura DXGKARG_DISCONNECTDOORBELL che descrive il campanello da disconnettere.

Valore restituito

DxgkDdiDisconnectDoorbell deve avere esito positivo e restituire STATUS_SUCCESS.

Commenti

Il sistema operativo chiama DxgkDdiDisconnectDoorbell per annullare il mapping della posizione del campanello fisico assegnato a questo campanello. KmD deve disconnettere la coda hardware, l'indirizzo fisico della porta e il motore e così via. La posizione del campanello fisico può essere assegnata a un altro oggetto campanello logico.

Il kmD non deve distruggere o liberare altri oggetti associati a hDoorbell perché l'oggettodoorbell non viene distrutto e può essere riconnesso in un secondo momento.

Al ritorno da questa chiamata DDI, Dxgkrnl esegue i passaggi seguenti per disconnettere il campanello:

Ruota il doorbell in modalità utenteCpuVirtualAddress in una pagina fittizia in modo che UMD non possa più scrivere nella posizione del campanello fisico.
Scrive D3DDDI_DOORBELL_STATUS_DISCONNECTED_RETRYinDoorbellStatusCpuVirtualAddress in modo che UMD sappia che il campanello è disconnesso.

Per altre informazioni, vedere Invio in modalità utente.