IDebugFailureAnalysis::GetBuffer method (extsfns.h)

The GetBuffer method searches a DebugFailureAnalysis object for the first FA entry that has a specified tag. If it finds an FA entry with the specified tag, it gets the entry's data block.

Syntax

PFA_ENTRY GetBuffer(
  [in]  FA_TAG Tag,
  [out] PVOID  Buf,
  [in]  ULONG  Size
);

Parameters

[in] Tag

A value in the FA_TAG enumeration.

[out] Buf

A pointer to a buffer that receives the entry's data block.

[in] Size

The size, in bytes, of the buffer pointed to by Buf.

Return value

If this method finds an FA entry with the specified tag, and if it succeeds in getting the data block, it returns a pointer to the FA_ENTRY structure. Otherwise, it returns NULL.

Remarks

If this method finds an FA entry with the specified tag, it checks to see whether the DataSize member of the FA_ENTRY structure is equal to the value specified by the Size parameter. If DataSize is not equal to Size, this method returns NULL and does not get the data block.

Requirements

Requirement Value
Target Platform Desktop
Header extsfns.h

See also

AddBuffer

IDebugFailureAnalysis2

SetBuffer

Writing an Analysis Extension Plug-in to Extend !analyze

_EFN_Analyze