DXGKDDI_DISCONNECTDOORBELL función de devolución de llamada (d3dkmddi.h)

Artículo
05/23/2024

Importante

Parte de la información se relaciona con un producto de versión preliminar que puede modificarse sustancialmente antes de su lanzamiento comercial. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

La función DxgkDdiDisconnectDoorbell desconecta un timbre de puerta conectado previamente de una cola de hardware.

Sintaxis

DXGKDDI_DISCONNECTDOORBELL DxgkddiDisconnectdoorbell;

NTSTATUS DxgkddiDisconnectdoorbell(
  INOUT_PDXGKARG_DISCONNECTDOORBELL pArgs
)
{...}

Parámetros

pArgs

[in/out] Puntero a una estructura de DXGKARG_DISCONNECTDOORBELL que describe el timbre para desconectar.

Valor devuelto

DxgkDdiDisconnectDoorbell debe realizarse correctamente y devolver STATUS_SUCCESS.

Comentarios

El sistema operativo llama a DxgkDdiDisconnectDoorbell para desasignar la ubicación física del timbre asignado a este timbre. KMD debe desconectar la cola de hardware, la dirección física del timbre de puerta y el motor, etc. La ubicación del timbre físico se puede asignar a algún otro objeto de timbre lógico.

KMD no debe destruir ni liberar ningún otro objeto asociado a hDoorbell porque el objeto de timbre no se está destruyendo y se puede volver a conectar en un momento posterior.

Al volver desde esta llamada DDI, Dxgkrnl realiza los pasos siguientes para desconectar el timbre de puerta:

Gira el modo de usuario DoorbellCpuVirtualAddress en una página fictica para que UMD ya no pueda escribir en la ubicación física del timbre.
Escribe D3DDDI_DOORBELL_STATUS_DISCONNECTED_RETRY en DoorbellStatusCpuVirtualAddress para que UMD sepa que el timbre está desconectado.

Para obtener más información, consulte Envío de trabajo en modo de usuario.