Поделиться через


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

Важный

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

D3DKMTDeskdoorbell уничтожает дверь.

Синтаксис

NTSTATUS D3DKMTDestroyDoorbell(
  D3DKMT_DESTROY_DOORBELL *unnamedParam1
);

Параметры

unnamedParam1

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

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

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

Замечания

Когда UMD вызывает D3DKMTDedoorbell, ОС выполняет следующие действия:

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

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 11 версии 24H2 (WDDM 3.2)
заголовка d3dkmthk.h

См. также

D3DKMT_DESTROY_DOORBELL

D3DKMTCreateDoorbell