estrutura DXGKARG_CONNECTDOORBELL (d3dkmddi.h)

Artigo
05/23/2024

Importante

Algumas informações estão relacionadas a um produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

A estrutura DXGKARG_CONNECTDOORBELL contém parâmetros para DxgkDdiConnectDoorbell.

Sintaxe

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

Membros

hDoorbell

[in] Identificador KMD para o objeto doorbell, que foi criado anteriormente usando DxgkDdiCreateDoorbell.

Flags

[in] Um campo de bits de valores de DXGKARG_CONNECTDOORBELL_FLAGS especificando os sinalizadores de conexão de campainha. Se a UMD criou essa campainha com o sinalizador RequireSecondaryCpuVA , dxgkrnl define o sinalizador RequireSecondaryAddress nesta DDI para informar ao KMD que essa campainha requer dois endereços físicos.

KernelCpuVirtualAddress

[out] Endereço virtual da CPU no modo kernel mapeado para o endereço físico que o KMD deseja atribuir a essa campainha. Dxgkrnl mapeará esse endereço para um endereço de processo endereço endereço CPU endereço virtual que foi fornecido para o UMD em D3DKMTCreateDoorbell. A UMD gravará um valor específico nesse endereço, efetivamente "tocando a campainha" para notificar o agendador de GPU de um novo envio de trabalho no hHwQueue.

SecondaryKernelCpuVirtualAddress

[out/optional] Endereço virtual da CPU no modo kernel mapeado para o endereço físico secundário que o KMD deseja atribuir a essa campainha, se necessário.

Status

[out] Um valor D3DDDI_DOORBELLSTATUS que o KMD deseja que Dxgkrnl grave na página visível para UMD para a qual pDoorbellStatusCpuVirtualAddress aponta. Esse valor só pode ser D3DDDI_DOORBELL_STATUS_CONNECTED ou D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY.