Функция 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 |