функция обратного вызова DXGKDDI_DESTROYMEMORYBASIS (d3dkmddi.h)

Статья
02/06/2025

Функция KMD DxgkDdiDesisMemoryBasis уничтожает базу памяти, созданную предыдущим вызовом DxgkDdiCreateMemoryBasis.

Синтаксис

DXGKDDI_DESTROYMEMORYBASIS DxgkddiDestroymemorybasis;

NTSTATUS DxgkddiDestroymemorybasis(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_HANDLE hMemoryBasis
)
{...}

Параметры

hAdapter

[in] Дескриптор для блока контекста, связанного с адаптером отображения. KMD ранее предоставил этот дескриптор для Dxgkrnl в параметр е вывода miniportDeviceContextDxgiDdiAddDevice.

hMemoryBasis

Обработка базы памяти для уничтожения. Этот дескриптор ранее был создан вызовом DxgkDdiCreateMemoryBasis.

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

DxgkDdiDesqlMemoryBasis возвращает STATUS_SUCCESS, если база памяти была успешно уничтожена. В противном случае возвращается код ошибки NTSTATUS. См. примечания.

Замечания

Dxgkrnl интерпретирует любой возвращенный NTSTATUS, который не STATUS_SUCCESS как катастрофическое уведомление об ошибке. Для возврата ничего, кроме успешного выполнения этой функции, не должно быть правильного функционирования, так как предполагается инвариантный, что предоставленный дескриптор является созданным и еще не уничтожен. Если KMD обнаруживает неправильные входные данные, возвращенный код ошибки позволяет Dxgkrnl назначить инвариантный сбой ядра ОС вместо сбоя драйвера.

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

Требования

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

См. также

DxgkDdiCreateMemoryBasis

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