Функция WerRegisterExcludedMemoryBlock (werapi.h)

Статья
07/27/2023

Помечает блок памяти (который обычно включается по умолчанию в отчеты об ошибках), который должен быть исключен из отчета об ошибках отчеты об ошибках Windows (WER).

Синтаксис

HRESULT WerRegisterExcludedMemoryBlock(
  const void *address,
  DWORD      size
);

Параметры

address

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

size

Размер блока памяти в байтах.

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

Эта функция возвращает S_OK при успешном выполнении или код ошибки при сбое, включая следующие коды ошибок.

Код возврата	Описание
E_INVALIDARG	адрес имеет значение NULL или размер равен 0.
E_OUTOFMEMORY	WER не удалось выделить достаточно большую кучу для данных
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Количество зарегистрированных записей превышает ограничение (WER_MAX_REGISTERED_ENTRIES).
WER_E_INVALID_STATE	Недопустимое состояние процесса. Например, процесс находится в режиме восстановления приложения.

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

Требования


Минимальная версия клиента	Windows 10, версия 1703 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2016 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	werapi.h
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

WerUnregisterExcludedMemoryBlock, отчеты об ошибках Windows

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