Поделиться через


функция обратного вызова DXGKDDI_CONNECTDOORBELL (d3dkmddi.h)

Важно!

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

DxgkDdiConnectDoorbell подключает (или повторно подключает) ранее созданный объект дверного звонка к аппаратной очереди.

Синтаксис

DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;

NTSTATUS DxgkddiConnectdoorbell(
  INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}

Параметры

pArgs

[вход/выход] Указатель на структуру DXGKARG_CONNECTDOORBELL , описывающую подключаемый дверный звонок.

Возвращаемое значение

DxgkDdiConnectDoorbell возвращает STATUS_SUCCESS, удалось ли KMD успешно подключить свой объект doorbell к указанной очереди оборудования. Обычно этот вызов не должен завершаться ошибкой; однако возвращенный код сбоя будет получен из gpu потерянных или остановленных типов неустранимых сценариев.

Комментарии

Когда UMD вызывает D3DKMTConnectDoorbell, ОС вызывает DxgkDdiConnectDoorbell , чтобы KMD мог выполнять следующие действия:

  • Укажите виртуальный адрес ЦП, сопоставленный с физическим расположением дверного звонка.
  • Установите необходимые подключения между объектом очереди оборудования, объектом doorbell, физическим адресом дверного звонка, планировщиком GPU и т. д.

При возвращении из этого DDI KMD следует считать этот физический адрес зарезервированным для конкретной очереди оборудования. Однако операционная система не имеет требования к уникальности для физического адреса дверного звонка. Это значит, что KMD может совместно использовать один и тот же физический адрес с несколькими логическими дверными колокольными или аппаратными очередями в зависимости от реализации оборудования. Например, некоторые аппаратные средства могут назначить один и тот же физический адрес всем аппаратным очередям одного контекста оборудования. Возможно даже, что несколько логических дверных колокольней используют одну и ту же физическую страницу размером 4 КБ, но используют уникальное смещение внутри страницы.

Дополнительные сведения см. в разделе Отправка рабочих данных в пользовательском режиме.

Требования

Требование Значение
Минимальная версия клиента Windows 11 версии 24H2 (WDDM 3.2)
Верхняя часть d3dkmddi.h
IRQL PASSIVE_LEVEL

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

D3DKMTConnectDoorbell

DXGKARG_CONNECTDOORBELL

DxgkDdiCreateDoorbell

DxgkDdiDisconnectDoorbell