функция обратного вызова DXGKDDI_CONNECTDOORBELL (d3dkmddi.h)
Важный
Некоторые сведения относятся к предварительному продукту, который может быть существенно изменен до его коммерческого выпуска. Корпорация Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых в отношении информации, предоставленной здесь.
DxgkDdiConnectDoorbell подключает (или повторно подключает) объект ранее созданный объект doorbell к очереди оборудования.
Синтаксис
DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;
NTSTATUS DxgkddiConnectdoorbell(
INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}
Параметры
pArgs
[in/out] Указатель на структуру DXGKARG_CONNECTDOORBELL, описывающую дверь для подключения.
Возвращаемое значение
DxgkDdiConnectDoorbell возвращает STATUS_SUCCESS, если KMD смог успешно подключить объект doorbell к указанной очереди оборудования. Обычно этот вызов не должен завершать ошибку; Однако возвращенный код сбоя будет получен из gpu потерянных или остановленных типов безвозвратных сценариев.
Замечания
Когда UMD вызывает D3DKMTConnectDoorbell, ОС вызывает DxgkDdiConnectDoorbell, чтобы KMD мог выполнить следующие действия:
- Укажите виртуальный адрес ЦП, сопоставленный с физическим расположением двери.
- Сделайте необходимые подключения между объектом аппаратной очереди, объектом doorbell, физическим адресом doorbell, планировщиком GPU и т. д.
При возврате из этого DDI KMD следует учитывать этот физический адрес как зарезервированный для конкретной очереди оборудования. Тем не менее, ос не имеет требования уникальности для физического адреса двери. То есть KMD может использовать один и тот же физический адрес с несколькими логическими очередями двери или аппаратными очередями в зависимости от реализации оборудования. Например, некоторые аппаратные средства могут назначать один и тот же физический адрес всем очередям оборудования одного контекста оборудования. Даже возможно, что несколько логических дверей используют одну и ту же физическую страницу 4 КБ, но используйте уникальное смещение на странице.
Дополнительные сведения см. в рабочей отправки в режиме пользователя.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 11 версии 24H2 (WDDM 3.2) |
| заголовка | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |