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

Статья
02/06/2025

Важный

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

Структура 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, указывающее флаги подключения doorbell. Если UMD создал эту дверь с флагом RequireSecondaryCpuVA, то Dxgkrnl задает флаг RequireSecondaryAddress в этом DDI, чтобы сообщить KMD, что для этого шлюза требуется два физических адреса.

KernelCpuVirtualAddress

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

SecondaryKernelCpuVirtualAddress

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

Status

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