IDebugFailureAnalysis2::SetBuffer 메서드(extsfns.h)

아티클
02/29/2024

SetBuffer 메서드는 지정된 태그가 있는 첫 번째 FA 항목에 대해 DebugFailureAnalysis 개체를 검색합니다. 지정된 태그가 있는 FA 항목을 찾으면 FA 항목의 데이터 블록을 지정된 버퍼의 바이트로 덮어씁니다. 이 메서드가 지정된 태그가 있는 FA 항목을 찾지 못하면 해당 태그가 있는 새 FA 항목을 만들고 지정된 버퍼의 데이터로 새 FA 항목의 데이터 블록을 덮어씁니다.

구문

PFA_ENTRY SetBuffer(
       FA_TAG        Tag,
  [in] FA_ENTRY_TYPE EntryType,
  [in] PVOID         Buf,
  [in] ULONG         Size
);

매개 변수

Tag

FA_TAG 열거형의 값입니다.

[in] EntryType

FA_ENTRY_TYPE 열거형의 값입니다. 이 매개 변수는 Buf에 있는 데이터의 데이터 형식을 지정합니다.

[in] Buf

새 FA 항목 또는 기존 FA 항목의 데이터 블록에 쓸 바이트가 포함된 버퍼에 대한 포인터입니다.

[in] Size

Buf가 가리키는 버퍼의 크기(바이트)입니다.

반환 값

이 메서드가 성공하면 새 또는 기존 FA_ENTRY 구조체에 대한 포인터를 반환합니다. 그렇지 않으면 NULL을 반환합니다.

설명

이 메서드는 지정된 태그가 있는 FA 항목을 찾은 경우 해당 태그와 연결된 데이터 형식이 EntryType에 지정된 데이터 형식과 호환되는지 확인합니다. 예를 들어 DEBUG_FA_ENTRY_ULONG64, DEBUG_FA_ENTRY_INSTRUCTION_OFFSET 및 DEBUG_FA_ENTRY_POINTER 모두 서로 호환됩니다. 마찬가지로 DEBUG_FA_ENTRY_ANSI_STRING 및 DEBUG_FA_ENTRY_EXTENSION_CMD 서로 호환됩니다. 데이터 형식이 호환되지 않으면 이 메서드는 NULL 을 반환하고 항목의 데이터 블록을 덮어쓰지 않습니다.

이 메서드가 지정된 태그가 있는 FA 항목을 찾지 못하면 해당 태그가 있는 새 FA 항목을 만들고 태그를 EntryType에서 지정한 데이터 형식과 연결합니다.