PEP_SOC_SUBSYSTEM_METADATA 구조체(pep_x.h)

  • 아티클

PEP_SOC_SUBSYSTEM_METADATA 구조에는 SoC(칩) 하위 시스템의 시스템에 대한 메타데이터를 포함하는 키-값 쌍이 포함되어 있습니다. PEP(플랫폼 확장 플러그 인)로 전송된 PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA 알림의 컨텍스트에서 사용됩니다.

구문

typedef struct _PEP_SOC_SUBSYSTEM_METADATA {
  [in/out] UNICODE_STRING Key;
  [in/out] UNICODE_STRING Value;
} PEP_SOC_SUBSYSTEM_METADATA, *PPEP_SOC_SUBSYSTEM_METADATA;

멤버

[in/out] Key

PEP가 메타데이터 문자열 쌍의 키 부분을 쓰는 버퍼입니다. 키 는 이 하위 시스템에 의해 보고된 모든 키 값 중에서 고유해야 합니다.

알림 콜백 루틴에 들어가기 전에 커널은 다음을 수행합니다.

  • Key.Buffer에 64개 WCHAR 미리 할당[]
  • 버퍼 0
  • Key.MaximumLength를 버퍼 크기(바이트)로 설정하고
  • Key.Length = 0 설정
콜백 루틴에서 종료하기 전에 PEP는 null로 종료된 문자열을 Key.Buffer에 복사하고 종료 UNICODE_NULL 포함하지 않고 복사된 UNICODE 문자 수의 sizeof(WCHAR)인 바이트 수로 Key.Length를 업데이트해야 합니다.

PEP는 Key.Buffer 의 주소가 가리키는 할당된 메모리를 사용하여 키를 제공해야 합니다. 이 메모리는 미리 할당되므로 크기를 변경할 수 없습니다. PEP는 필요한 경우 키 문자열을 잘려 서 Key.MaximumLength 에 지정된 길이(종료 UNICODE_NULL 문자 포함)를 초과하지 않도록 합니다.

[in/out] Value

PEP가 메타데이터 문자열 쌍의 값 부분을 쓰는 버퍼입니다.

알림 콜백 루틴에 들어가기 전에 커널은 다음을 수행합니다.

  • Value.Buffer에 64개 WCHAR 미리 할당[]
  • 버퍼 0
  • Value.MaximumLength를 버퍼 크기(바이트)로 설정하고
  • Value.Length = 0 설정
콜백 루틴에서 종료하기 전에 PEP는 null로 종료된 문자열을 Value.Buffer 로 복사하고 Value.Length 를 sizeof(WCHAR) 인 바이트 수로 업데이트해야 하며, 종료 UNICODE_NULL 포함하지 않고 복사된 유니코드 문자의 수를 곱해야 합니다.

PEP는 Value.Buffer 의 주소가 가리키는 할당된 메모리를 사용하여 메타데이터 값을 제공해야 합니다. 이 메모리는 미리 할당되므로 크기를 변경할 수 없습니다. PEP는 필요한 경우 Value.MaximumLength 에 지정된 길이(종료 UNICODE_NULL 문자 포함)를 초과하지 않도록 값 문자열을 잘려야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 부터 지원합니다.
머리글 pep_x.h(Pep_x.h 포함)

추가 정보

PEP_DPM_QUERY_SOC_SUBSYSTEM_METADATA

PEP_QUERY_SOC_SUBSYSTEM_METADATA