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

DxgkDdiConnectDoorbell conecta (o vuelve a conectar) un objeto de timbre de puerta creado anteriormente a una cola de hardware.

Sintaxis

DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;

NTSTATUS DxgkddiConnectdoorbell(
  INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}

Parámetros

pArgs

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

Valor devuelto

DxgkDdiConnectDoorbell devuelve STATUS_SUCCESS si KMD pudo conectar correctamente su objeto de timbre a la cola de hardware especificada. Esta llamada no suele producir un error; sin embargo, un código de error devuelto provendría de tipos perdidos o detenidos de gpu de escenarios irrecuperables.

Comentarios

Cuando UMD llama a D3DKMTConnectDoorbell, el sistema operativo llama a DxgkDdiConnectDoorbell para que el KMD pueda hacer lo siguiente:

Proporcione una dirección virtual de CPU asignada a la ubicación del timbre físico.
Realice las conexiones necesarias entre el objeto de cola de hardware, el objeto de timbre, la dirección física del timbre, el programador de GPU, etc.

Al volver desde esta DDI, KMD debe considerar esta dirección física como reservada para esta cola de hardware determinada. Sin embargo, el sistema operativo no tiene un requisito de unicidad para la dirección física del timbre. Es decir, KMD puede optar por compartir la misma dirección física con varias colas lógicas de timbre o hardware en función de la implementación de hardware. Por ejemplo, algún hardware podría optar por asignar la misma dirección física a todas las colas de hardware de un único contexto de hardware. Incluso es posible que varios timbres lógicos compartan la misma página física de 4 KB, pero usen un desplazamiento único dentro de la página.

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