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

Artículo
02/26/2024

El método SetBuffer busca en un objeto DebugFailureAnalysis la primera entrada fa que tiene una etiqueta especificada. Si encuentra una entrada fa con la etiqueta especificada, sobrescribe el bloque de datos de la entrada fa con los bytes de un búfer especificado. Si este método no encuentra una entrada fa que tenga la etiqueta especificada, crea una nueva entrada fa con esa etiqueta y sobrescribe el bloque de datos de la nueva entrada fa con los datos del búfer especificado.

Sintaxis

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

Parámetros

Tag

Valor de la enumeración FA_TAG .

[in] EntryType

Valor de la enumeración FA_ENTRY_TYPE . Este parámetro especifica el tipo de datos de los datos en Buf.

[in] Buf

Puntero a un búfer que contiene los bytes que se van a escribir en el bloque de datos de la entrada fa nueva o existente.

[in] Size

Tamaño, en bytes, del búfer al que apunta Buf.

Valor devuelto

Si este método se ejecuta correctamente, devuelve un puntero a la estructura de FA_ENTRY nueva o existente. De lo contrario, devuelve NULL.

Comentarios

Si este método encuentra una entrada fa con la etiqueta especificada, comprueba si el tipo de datos asociado a esa etiqueta es compatible con el tipo de datos especificado por EntryType. Por ejemplo, DEBUG_FA_ENTRY_ULONG64, DEBUG_FA_ENTRY_INSTRUCTION_OFFSET y DEBUG_FA_ENTRY_POINTER son compatibles entre sí. Del mismo modo, DEBUG_FA_ENTRY_ANSI_STRING y DEBUG_FA_ENTRY_EXTENSION_CMD son compatibles entre sí. Si los tipos de datos no son compatibles, este método devuelve NULL y no sobrescribe el bloque de datos de la entrada.

Si este método no encuentra una entrada fa con la etiqueta especificada, crea una nueva entrada fa con esa etiqueta y asocia la etiqueta con el tipo de datos especificado por EntryType.