IDebugFailureAnalysis::GetUlong64 메서드(extsfns.h)

아티클
02/29/2024

GetUlong64 메서드는 지정된 태그가 있는 첫 번째 FA 항목에 대해 DebugFailureAnalysis 개체를 검색합니다. 지정된 태그가 있는 FA 항목을 찾으면 항목의 데이터 블록에서 ULONG64 값을 가져옵니다.

구문

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

매개 변수

Tag

FA_TAG 열거형의 값입니다.

[out] Value

항목의 데이터 블록에서 값을 받는 ULONG64 대한 포인터입니다.

반환 값

이 메서드는 지정된 태그가 있는 FA 항목을 찾은 후 데이터 블록을 가져오는 데 성공하면 FA_ENTRY 구조체에 대한 포인터를 반환합니다. 그렇지 않으면 NULL을 반환합니다.

설명

이 메서드는 지정된 태그가 있는 FA 항목을 찾으면 FA_ENTRY 구조의 DataSize 멤버가 ULONG64 크기와 같은지 확인합니다. DataSize가 ULONG64 크기와 같지 않으면 이 메서드는 NULL을 반환하고 데이터 블록을 얻지 못합니다.

DebugFailureAnalysis 개체에 이미 사용된 각 태그는 FA_ENTRY_TYPE 열거형의 데이터 형식 중 하나와 연결됩니다. 태그와 연결된 데이터 형식을 확인하려면 IDebugFAEntryTags 인터페이스의 GetType 메서드를 호출합니다. IDebugFAEntryTags 인터페이스에 대한 포인터를 얻으려면 IDebugFailureAnalysis2 인터페이스의 GetDebugFATagControl 메서드를 호출합니다.

이 메서드의 적절한 사용은 데이터 형식이 DEBUG_FA_ENTRY_ULONG64 또는 DEBUG_FA_ENTRY_INSTRUCTION_OFFSET 또는 DEBUG_FA_ENTRY_POINTERFA 항목에서 데이터 블록을 가져오는 것입니다.