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

Статья
05/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 может инициализировать свое состояние дверного звонка.

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