функция обратного вызова DXGKDDI_CREATEDOORBELL (d3dkmddi.h)
Важный
Некоторые сведения относятся к предварительному продукту, который может быть существенно изменен до его коммерческого выпуска. Корпорация Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых в отношении информации, предоставленной здесь.
ОС вызывает функцию обратного вызова KMD DxgkDdiCreateDoorbell для создания двери для очереди оборудования.
Синтаксис
DXGKDDI_CREATEDOORBELL DxgkddiCreatedoorbell;
NTSTATUS DxgkddiCreatedoorbell(
INOUT_PDXGKARG_CREATEDOORBELL pArgs
)
{...}
Параметры
pArgs
[in/out] Указатель на структуру DXGKARG_CREATEDOORBELL, описывающую дверь.
Возвращаемое значение
DxgkDdiCreateDoorbell возвращает STATUS_SUCCESS, если KMD смог успешно создать объект doorbell для указанной очереди оборудования, и UMD может использовать эту дверь для отправки рабочих данных. В противном случае возвращается соответствующий код ошибки NTSTATUS. UMD не может использовать дверь для отправки рабочих данных, если KMD возвращает код сбоя.
Замечания
Когда UMD вызывает D3DKMTCreateDoorbell для создания двери для очереди оборудования, ОС делает соответствующий DxgkDdiCreateDoorbell вызов KMD, чтобы KMD мог инициализировать структуры двери.
Функция KMD DxgkDdiCreateDoorbell должна создавать и инициализировать структуры данных doorbell. Он не должен назначать физическое расположение двери для этого объекта doorbell еще, как это делается во время последующего вызова DxgkDdiConnectDoorbell. Это отложенное назначение гарантирует, что физическая дверь не используется во время создания аппаратной очереди и двери, только чтобы идти впустую в случае, если UMD никогда не отправляет команды в него или начинает отправлять команды позже. Таким образом, физические двери используются только при необходимости.
Дополнительные сведения см. в рабочей отправки в режиме пользователя.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 11 версии 24H2 (WDDM 3.2) |
| заголовка | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |