Функция D3DKMTDeкистройДоорбелл (d3dkmthk.h)

  • Статья

Важно!

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

D3DKMTDeкистройDoorbell уничтожает объект дверного звонка.

Синтаксис

NTSTATUS D3DKMTDestroyDoorbell(
  D3DKMT_DESTROY_DOORBELL *unnamedParam1
);

Параметры

unnamedParam1

[in] Указатель на структуру D3DKMT_DESTROY_DOORBELL , идентифицирующая очередь оборудования, чей дверный звонок должен быть уничтожен.

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

D3DKMTDeкистройDoorbell возвращает STATUS_SUCCESS, когда ОС успешно уничтожает объект дверного звонка. Если hDoorbell указывает на допустимый дверной звонок, то этот вызов всегда выполняется успешно; в противном случае возвращается STATUS_INVALID_PARAMETER.

Комментарии

Когда UMD вызывает D3DKMTDeкистройDoorbell, ОПЕРАЦИОННая система выполняет следующие действия:

  • Удаляет ссылку на выделения hRingBuffer и hRingBufferControl , принадлежащие этому дверной звонку.
  • Освобождает сопоставление, на которое указывает pDoorbellStatusCPUVirtualAddress .
  • Освобождает сопоставления пользовательского режима и режима ядра, на которые указывает pDoorbellCPUVirtuslAddress .
  • Вызывает функцию KMD [DxgkDdiDe переборбелл], чтобы KMD мог отключить физическое расположение дверного звонка и уничтожить его объекты дверного звонка.

UMD не должен использовать дескриптор после вызова D3DKMTDestroyDoorbell.

Требования

Требование Значение
Минимальная версия клиента WIN11_FUTURE
Верхняя часть d3dkmthk.h

См. также раздел

D3DKMT_DESTROY_DOORBELL

D3DKMTCreateDoorbell