estructura DXGKARG_CONNECTDOORBELL (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 estructura DXGKARG_CONNECTDOORBELL contiene parámetros para DxgkDdiConnectDoorbell.

Sintaxis

typedef struct _DXGKARG_CONNECTDOORBELL {
  HANDLE                        hDoorbell;
  DXGKARG_CONNECTDOORBELL_FLAGS Flags;
  void                          *KernelCpuVirtualAddress;
  void                          *SecondaryKernelCpuVirtualAddress;
  D3DDDI_DOORBELLSTATUS         Status;
} DXGKARG_CONNECTDOORBELL;

Miembros

hDoorbell

[in] Identificador KMD para el objeto de timbre, que se creó anteriormente con DxgkDdiCreateDoorbell.

Flags

[in] Campo de bits de DXGKARG_CONNECTDOORBELL_FLAGS valores que especifican las marcas de conexión de timbre. Si UMD creó este timbre con la marca RequireSecondaryCpuVA , Dxgkrnl establece la marca RequireSecondaryAddress en este DDI para informar al KMD de que este timbre requiere dos direcciones físicas.

KernelCpuVirtualAddress

[out] Dirección virtual de CPU en modo kernel asignada a la dirección física que KMD quiere asignar a este timbre de puerta. Dxgkrnl asignará esta dirección a una dirección virtual de CPU del espacio de direcciones de proceso que se proporcionó al UMD en D3DKMTCreateDoorbell. UMD escribirá un valor específico en esta dirección, "llamando al timbre" para notificar al programador de GPU un nuevo envío de trabajo en hHwQueue.

SecondaryKernelCpuVirtualAddress

[out/optional] Dirección virtual de CPU en modo kernel asignada a la dirección física secundaria que KMD quiere asignar a este timbre de puerta, si es necesario.

Status

[out] Valor D3DDDI_DOORBELLSTATUS que KMD quiere que Dxgkrnl escriba en la página visible de UMD a la que apunta pDoorbellStatusCpuVirtualAddress . Este valor solo puede ser D3DDDI_DOORBELL_STATUS_CONNECTED o D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY.