Método IDebugFailureAnalysis2::SetBuffer (extsfns.h)
El método SetBuffer busca un objeto DebugFailureAnalysis para el primer de entrada fa de 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 un entrada fa que tiene 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 de 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 de .
[in] Size
Tamaño, en bytes, del búfer al que apunta Buf.
Valor devuelto
Si este método se realiza correctamente, devuelve un puntero a la estructura de FA_ENTRY nueva o existente. De lo contrario, devuelve NULL.
Observaciones
Si este método encuentra una entrada fa de 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_OFFSETy 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 un entrada FA con la etiqueta especificada, crea una nueva entrada fa con esa etiqueta y asocia la etiqueta al tipo de datos especificado por EntryType.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | extsfns.h |
Consulte también
escribir un complemento de extensión de análisis para ampliar !analyze