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

Статья
05/26/2023

Важно!

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

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

Синтаксис

DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;

NTSTATUS DxgkddiConnectdoorbell(
  INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}

Параметры

pArgs

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

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

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

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

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