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

El sistema operativo llama a la función de devolución de llamada DxgkDdiCreateDoorbell de KMD para crear un timbre para una cola de hardware.

Sintaxis

DXGKDDI_CREATEDOORBELL DxgkddiCreatedoorbell;

NTSTATUS DxgkddiCreatedoorbell(
  INOUT_PDXGKARG_CREATEDOORBELL pArgs
)
{...}

Parámetros

pArgs

[in/out] Puntero a una estructura de DXGKARG_CREATEDOORBELL que describe el timbre.

Valor devuelto

DxgkDdiCreateDoorbell devuelve STATUS_SUCCESS si KMD pudo crear correctamente su objeto de timbre para la cola de hardware especificada y UMD puede usar este timbre para el envío de trabajo. De lo contrario, devuelve un código de error NTSTATUS adecuado. UMD no puede usar el timbre para el envío de trabajo si KMD devuelve cualquier código de error.

Comentarios

Cuando UMD llama a D3DKMTCreateDoorbell para crear un timbre de puerta para una cola de hardware, el sistema operativo realiza una llamada DxgkDdiCreateDoorbell correspondiente a KMD para que KMD pueda inicializar sus estructuras de timbre.

La función DxgkDdiCreateDoorbell de KMD solo debe crear e inicializar sus estructuras de datos de timbre. No debe asignar una ubicación de timbre físico a este objeto de timbre, ya que se realiza durante una llamada posterior a DxgkDdiConnectDoorbell. Esta asignación diferida garantiza que un timbre físico no se use durante la creación de la cola de hardware y del timbre, solo para ir desperdiciado en caso de que UMD nunca envíe comandos a él o empiece a enviar comandos más adelante. De este modo, los timbres físicos solo se usan cuando realmente es necesario.

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