IDebugFailureAnalysis2::GetBuffer method

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

Tag [in]

A value in the FA_TAG enumeration.

Buf [out]

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

Size [in]

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

Target platform

Desktop

Header

Extsfns.h

See also

IDebugFailureAnalysis2
Writing an Analysis Extension Plug-in to Extend !analyze
SetBuffer
AddBuffer
_EFN_Analyze

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft