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

Статья
05/26/2023

Важно!

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

ОС вызывает функцию обратного вызова DxgkDdiCreateDoorbell KMD для создания дверного звонка для аппаратной очереди.

Синтаксис

DXGKDDI_CREATEDOORBELL DxgkddiCreatedoorbell;

NTSTATUS DxgkddiCreatedoorbell(
  INOUT_PDXGKARG_CREATEDOORBELL pArgs
)
{...}

Параметры

pArgs

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

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

DxgkDdiCreateDoorbell возвращает STATUS_SUCCESS, удалось ли KMD успешно создать свой объект doorbell для указанной очереди оборудования, и UMD может использовать этот дверной звонок для отправки работы. В противном случае возвращается соответствующий код ошибки NTSTATUS. UMD не может использовать дверный звонок для отправки работы, если KMD возвращает код сбоя.

Когда UMD вызывает D3DKMTCreateDoorbell для создания дверного звонка для аппаратной очереди, ОС выполняет соответствующий вызов DxgkDdiCreateDoorbell к KMD, чтобы KMD мог инициализировать свои структуры дверных звонков.

Функция DXGkDdiCreateDoorbell KMD должна создавать и инициализировать только структуры данных doorbell. Он не должен назначать физическое расположение дверного звонка этому объекту, как это делается во время последующего вызова DxgkDdiConnectDoorbell. Это отложенное назначение гарантирует, что физический дверный звонок не будет использоваться во время создания аппаратной очереди и дверного звонка, а только в том случае, если UMD никогда не отправляет команды в него или начинает отправлять команды позже. Таким образом, физические дверные колокола используются только тогда, когда это действительно необходимо.