다음을 통해 공유

Tbsi_Physical_Presence_Command 함수(tbs.h)

  • 아티클

TBS를 통해 물리적 현재 상태 ACPI 명령을 드라이버에 전달합니다.

구문

TBS_RESULT Tbsi_Physical_Presence_Command(
  [in]      TBS_HCONTEXT hContext,
  [in]      PCBYTE       pabInput,
  [in]      UINT32       cbInput,
  [out]     PBYTE        pabOutput,
  [in, out] PUINT32      pcbOutput
);

매개 변수

[in] hContext

ACPI 명령의 컨텍스트입니다.

[in] pabInput

ACPI 명령에 대한 입력을 포함하는 버퍼에 대한 포인터입니다.

ACPI 명령에 대한 입력은 의 TCG 물리적 프레즌스 인터페이스 사양 에 정의되어 있습니다 https://www.trustedcomputinggroup.org. 버퍼에는 이 문서에 정의된 Arg2 및 Arg3 값이 포함되어야 합니다. Arg0 및 Arg1의 값은 정적이며 자동으로 추가됩니다. 예를 들어 이 메서드가 실제 프레즌스 인터페이스 버전 가져오기에 사용되는 경우 Arg2 는 정수 값 1이고 Arg3 은 비어 있으므로 버퍼는 정수 값 1만 포함해야 합니다. 이 메서드가 "사전 OS 환경에 TPM 작업 요청 제출"에 사용되는 경우 Arg2 는 정수 값 2이고 Arg3 은 지정된 작업의 정수(예: 사용하려면 1, 사용 안 함의 경우 2)입니다.

[in] cbInput

입력 버퍼의 길이(바이트)입니다.

[out] pabOutput

ACPI 명령의 출력을 포함하는 버퍼에 대한 포인터입니다.

버퍼에는 TCG 물리적 프레즌스 인터페이스 사양에 정의된 대로 명령의 반환 값이 포함됩니다.

[in, out] pcbOutput

입력 시 출력 버퍼의 크기(바이트)를 지정하는 부호 없는 긴 정수에 대한 포인터입니다. 함수가 성공하면 출력 시 이 매개 변수는 pabOutput이 가리키는 데이터의 크기(바이트)를 받습니다. 함수가 실패하면 이 매개 변수는 값을 받지 않습니다.

반환 값

함수가 성공하면 함수는 TBS_SUCCESS 반환합니다.

함수가 실패하면 오류를 나타내는 TBS 반환 코드를 반환합니다.

반환 코드/값 설명
TBS_SUCCESS
0(0x0)
 함수가 성공했습니다.
TBS_E_BAD_PARAMETER
2150121474(0x80284002)
 하나 이상의 매개 변수 값이 잘못되었습니다.
TBS_E_INTERNAL_ERROR
2150121473(0x80284001)
 내부 소프트웨어 오류가 발생했습니다.
TBS_E_INVALID_CONTEXT_PARAM
2150121479(0x80284007)
 TBS 컨텍스트를 만들려고 할 때 유효하지 않은 컨텍스트 매개 변수가 전달되었습니다.
TBS_E_INVALID_OUTPUT_POINTER
2150121475(0x80284003)
 지정된 출력 포인터가 잘못되었습니다.

설명

자세한 내용은 TCG 물리적 프레즌스 인터페이스 사양을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 tbs.h
라이브러리 Tbs.lib
DLL Tbs.dll