다음을 통해 공유


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포함하지 않고 복사된 유니코드 문자 수의 배인 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 업데이트해야 하며, 종료 UNICODE_NULL포함하지 않고 복사된 유니코드 문자 수의 배에 sizeof(WCHAR)인 바이트 수로 업데이트해야 합니다.

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