Método IDebugFailureAnalysis2::SetBuffer (extsfns.h)

Artigo
02/06/2025

O método SetBuffer pesquisa um objeto DebugFailureAnalysis para a primeira entrada da FA que tem uma marca especificada. Se encontrar uma entrada FA com a marca especificada, ela substituirá o bloco de dados da entrada fa com os bytes em um buffer especificado. Se esse método não encontrar uma entrada fa que tenha a marca especificada, ele criará uma nova entrada FA com essa marca e substituirá o bloco de dados da nova entrada FA com os dados no buffer especificado.

Sintaxe

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

Parâmetros

Tag

Um valor na enumeração FA_TAG.

[in] EntryType

Um valor na enumeração FA_ENTRY_TYPE. Esse parâmetro especifica o tipo de dados dos dados em buf.

[in] Buf

Um ponteiro para um buffer que contém os bytes a serem gravados no bloco de dados da entrada fa nova ou existente .

[in] Size

O tamanho, em bytes, do buffer apontado por buf.

Valor de retorno

Se esse método for bem-sucedido, ele retornará um ponteiro para a estrutura de FA_ENTRY nova ou existente. Caso contrário, ele retornará NULL.

Observações

Se esse método encontrar uma entrada fa com a marca especificada, ele verificará se o tipo de dados associado a essa marca é compatível com o tipo de dados especificado por EntryType. Por exemplo, DEBUG_FA_ENTRY_ULONG64, DEBUG_FA_ENTRY_INSTRUCTION_OFFSETe DEBUG_FA_ENTRY_POINTER são todos compatíveis uns com os outros. Da mesma forma, DEBUG_FA_ENTRY_ANSI_STRING e DEBUG_FA_ENTRY_EXTENSION_CMD são compatíveis uns com os outros. Se os tipos de dados não forem compatíveis, esse método retornará NULL e não substituirá o bloco de dados da entrada.

Se esse método não encontrar uma entrada fa com a marca especificada, ele criará uma nova entrada FA com essa marca e associará a marca ao tipo de dados especificado por EntryType.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	extsfns.h

Consulte também

do AddBuffer

GetBuffer

IDebugFailureAnalysis2

escrever um plug-in de extensão de análise para estender !analisar

_EFN_Analyze

Partilhar via