структура DXGKARG_CONNECTDOORBELL (d3dkmddi.h)

  • Статья

Важно!

Некоторые сведения относятся к предварительной версии продукта, который может быть существенно изменен до его коммерческого выпуска. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Структура DXGKARG_CONNECTDOORBELL содержит параметры для DxgkDdiConnectDoorbell.

Синтаксис

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

Члены

hDoorbell

[in] Дескриптор KMD для объекта doorbell, который ранее был создан с помощью DxgkDdiCreateDoorbell.

Flags

[in] Битовое поле DXGKARG_CONNECTDOORBELL_FLAGS значений , указывающих флаги подключения к дверной звоноку. Если UMD создал этот звонок с флагом RequireSecondaryCpuVA , dxgkrnl устанавливает флаг RequireSecondaryAddress в этом DDI, чтобы сообщить KMD, что для этого дверной звонок требуется два физических адреса.

KernelCpuVirtualAddress

[out] Виртуальный адрес ЦП в режиме ядра, сопоставленный с физическим адресом, который KMD хочет назначить этому звонку. Dxgkrnl сопоставит этот адрес с виртуальным адресным адресом ЦП для адресного пространства процесса, который был предоставлен UMD в D3DKMTCreateDoorbell. UMD запишет определенное значение на этот адрес, фактически "звоня в дверь", чтобы уведомить планировщик GPU о новой отправке работ на HwQueue1.

SecondaryKernelCpuVirtualAddress

[out/optional] Виртуальный адрес ЦП в режиме ядра, сопоставленный с дополнительным физическим адресом, который KMD хочет назначить этому дверной звонку, если это необходимо.

Status

[out] Значение D3DDDI_DOORBELLSTATUS , которое KMD хочет, чтобы Dxgkrnl записывал на видимую UMD страницу, на которую указывает pDoorbellStatusCpuVirtualAddress . Это значение может быть только D3DDDI_DOORBELL_STATUS_CONNECTED или D3DDDI_DOORBELL_STATUS_CONNECTED_NOTIFY.

Требования

Требование Значение
Минимальная версия клиента WIN11_FUTURE
Верхняя часть d3dkmddi.h

См. также раздел

D3DDDI_DOORBELLSTATUS

D3DKMTCreateDoorbell

DXGKARG_CONNECTDOORBELL_FLAGS

DxgkDdiConnectDoorbell