Метод IDebugFailureAnalysis2::SetBuffer (extsfns.h)

Метод setBuffer выполняет поиск объекта DebugFailureAnalysis для первой записи FA с указанным тегом. Если он находит запись FA с указанным тегом, он перезаписывает блок данных записи FA с байтами в указанном буфере. Если этот метод не находит запись FA с указанным тегом, она создает новую запись FA с этим тегом и перезаписывает блок данных новой записи FA данными в указанном буфере.

Синтаксис

PFA_ENTRY SetBuffer(
       FA_TAG        Tag,
  [in] FA_ENTRY_TYPE EntryType,
  [in] PVOID         Buf,
  [in] ULONG         Size
);

Параметры

Tag

Значение в перечислении FA_TAG.

[in] EntryType

Значение в перечислении FA_ENTRY_TYPE. Этот параметр задает тип данных в Buf.

[in] Buf

Указатель на буфер, содержащий байты, записываемые в блок данных новой или существующей записи FA.

[in] Size

Размер буфера в байтах, на который указывает Buf.

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

Если этот метод выполнен успешно, он возвращает указатель на новую или существующую FA_ENTRY структуру. В противном случае возвращается NULL.

Замечания

Если этот метод находит записи FA с указанным тегом, он проверяет, совместим ли тип данных, связанный с этим тегом, с типом данных, указанным EntryType. Например, DEBUG_FA_ENTRY_ULONG64, DEBUG_FA_ENTRY_INSTRUCTION_OFFSETи DEBUG_FA_ENTRY_POINTER совместимы друг с другом. Аналогичным образом, DEBUG_FA_ENTRY_ANSI_STRING и DEBUG_FA_ENTRY_EXTENSION_CMD совместимы друг с другом. Если типы данных несовместимы, этот метод возвращает null и не перезаписывает блок данных записи.

Если этот метод не находит записи FA с указанным тегом, он создает новую запись FA с этим тегом и связывает тег с типом данных, указанным EntryType.

Требования

См. также

AddBuffer

GetBuffer

IDebugFailureAnalysis2

написание подключаемого модуля расширения анализа для расширения !analysis

_EFN_Analyze