Функция D3DKMTCreateDoorbell (d3dkmthk.h)

Статья
02/23/2024

Важно!

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

Функция D3DKMTCreateDoorbell создает дверной звонок GPU для очереди оборудования D3D для отправки в пользовательском режиме.

Синтаксис

NTSTATUS D3DKMTCreateDoorbell(
  D3DKMT_CREATE_DOORBELL *unnamedParam1
);

Параметры

unnamedParam1

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

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

D3DKMTCreateDoorbell возвращает STATUS_SUCCESS, когда ОС успешно создает дверной звонок для этой очереди оборудования, которую UMD может использовать для отправки работы. Любой код возврата ошибки означает, что звонок в дверь не был создан, и UMD не может использовать его для отправки работы.

D3DKMTCreateDoorbell создает объект doorbell, который инициализирован как отключенный. UMD должен вызвать D3DKMTConnectDoorbell , прежде чем использовать этот звонок для отправки команд в очередь оборудования.

Когда UMD вызывает D3DKMTCreateDoorbell, ОПЕРАЦИОННая система выполняет соответствующий вызов обратного вызова DxgkDdiCreateDoorbell KMD, в котором KMD может инициализировать свое состояние дверного звонка.