Función D3DKMTConnectDoorbell (d3dkmthk.h)

Importante

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

D3DKMTConnectDoorbell conecta (o vuelve a conectar) un de timbre creado anteriormente en una cola de hardware.

Sintaxis

NTSTATUS D3DKMTConnectDoorbell(
  D3DKMT_CONNECT_DOORBELL *unnamedParam1
);

Parámetros

unnamedParam1

[in] Puntero a una estructura *D3DKMT_CONNECT_DOORBELL* que describe el timbre para conectarse.

Valor devuelto

D3DKMTConnectDoorbell devuelve STATUS_SUCCESS cuando el sistema operativo conecta correctamente el timbre a la cola de hardware y UMD puede usar este timbre de puerta para el envío de trabajo. Normalmente, esta llamada no debería producir un error; sin embargo, un código de error sería de gpu perdida o detención de tipos de escenarios irrecuperables.

Observaciones

Cada vez que el UMD envía un nuevo trabajo a la cola de hardware y llama al timbre, debe leer el DoorbellStatusCPUVirtualAddress para comprobar si el anillo de timbre de puerta se realizó correctamente. En caso de error, UMD debe llamar a D3DKMTConnectDoorbell para volver a conectar el timbre y, a continuación, intentar el envío de nuevo.

Un timbre se puede desconectar por varias razones:

• Cuando se crea un timbre, el sistema operativo lo inicializa en un estado "desconectado" y solo lo conecta cuando UMD llama a D3DKMTConnectDoorbell por primera vez.
• El timbre se "victimizó" en hardware que admite el modelo de timbre dedicado. Es decir, el timbre físico de esta cola de hardware se asignó a otra cola de hardware. Es probable que esta reasignación se deba a que hay más colas de hardware creadas en la GPU que las timbres físicas.
• El timbre se desconectaba como parte de suspender la cola de hardware o encender la GPU.

Cuando UMD llama D3DKMTConnectDoorbell para conectar el timbre de puerta asignado a una cola de hardware, el sistema operativo realiza una llamada DxgkDdiConnectDoorbell a KMD, de modo que el KMD pueda encontrar un timbre físico, asignarlo a esta cola de hardware y realizar las conexiones necesarias entre la cola de hardware, el timbre de puerta, el programador de GPU, etc.

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

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 11, versión 24H2 (WDDM 3.2)
encabezado de	d3dkmthk.h

Consulte también

D3DKMT_CONNECT_DOORBELL

D3DKMTCreateDoorbell

DxgkDdiConnectDoorbell