Метод IDebugFailureAnalysis::GetUlong64 (extsfns.h)

Метод GetUlong64 выполняет поиск объекта DebugFailureAnalysis для первой записи FA с указанным тегом. Если он находит запись FA с указанным тегом, он получает значение ULONG64 из блока данных записи.

Синтаксис

PFA_ENTRY GetUlong64(
        FA_TAG   Tag,
  [out] PULONG64 Value
);

Параметры

Tag

Значение в перечислении FA_TAG.

[out] Value

Указатель на ULONG64, получающий значение из блока данных записи.

Возвращаемое значение

Если этот метод находит записи FA с указанным тегом, и если он успешно получает блок данных, он возвращает указатель на структуру FA_ENTRY. В противном случае возвращается NULL.

Замечания

Если этот метод находит запись FA с указанным тегом, проверяет, равен ли элемент DataSize структуры FA_ENTRY размеру ULONG64. Если DataSize не равен размеру ULONG64, этот метод возвращает NULL и не получает блок данных.

Каждый тег, который уже использовался в объекте DebugFailureAnalysis, связан с одним из типов данных в перечислении FA_ENTRY_TYPE. Чтобы определить тип данных, связанный с тегом, вызовите метод GetType интерфейса IDebugFAEntryTags. Чтобы получить указатель на интерфейс IDebugFAEntryTags, вызовите метод GetDebugFATagControl интерфейса IDebugFailureAnalysis2.

Соответствующее использование этого метода — получение блока данных из записи FA с типом данных DEBUG_FA_ENTRY_ULONG64 или DEBUG_FA_ENTRY_INSTRUCTION_OFFSET или DEBUG_FA_ENTRY_POINTER.

Требования

См. также

AddUlong64

IDebugFailureAnalysis2

SetUlong64

написание подключаемого модуля расширения анализа для расширения !analysis

_EFN_Analyze