TPM 程序设计基础 1-2-2 ：旧的 PCR 命令

Old PCR Commands

旧的 PCR 命令。

• 注意：本文只提供相关函数的说明、定义、参数、返回值、注释等的简单翻译，对于更多信息、疑问或错误之处，请阅读原英文文档。

Tspi_TPM_GetEvent

《TSS V1.2.pdf》 P282 4.3.4.12.1 Tspi_TPM_GetEvent

信息说明开始
该方法为给定的PCR指标和事件数提供PCR事件。
信息说明结束

定义
	TSS_RESULT Tspi_TPM_GetEvent 
	(
        TSS_HTPM hTPM, // in
        UINT32 ulPcrIndex, // in
        UINT32 ulEventNumber, // in
        TSS_PCR_EVENT* pPcrEvent // out
	);


参数
    hTPM
    	TPM对象的句柄
    ulPcrIndex
    	指标要求PCR。
    ulEventNumber
    	要请求的事件的索引。
    pPcrEvent
    	接收PCR事件数据。

返回值
	TSS_SUCCESS
	TSS_E_INVALID_HANDLE
	TSS_E_BAD_PARAMETER
	TSS_E_INTERNAL_ERROR

注释

Tspi_TPM_GetEvents

《TSS V1.2.pdf》 P283 4.3.4.12.2 Tspi_TPM_GetEvents

信息说明开始
该方法为给定的指标提供特定数量的PCR事件。
信息说明结束

定义
	TSS_RESULT Tspi_TPM_GetEvents
	(
        TSS_HTPM hTPM, // in
        UINT32 ulPcrIndex, // in
        UINT32 ulStartNumber, // in
        UINT32* pulEventNumber, // in, out
        TSS_PCR_EVENT** prgPcrEvents // out
	);

参数
    hTPM
    	TPM对象的句柄
    ulPcrIndex
    	指标要求PCR。
    ulStartNumber
    	请求的第一个事件的索引。
    pulEventNumber
    	[IN]请求元素的数量。[OUT]在prgpcre参数中接收返回的事件数据结构的数量
    prgPcrEvents
    	接收指向PCR事件数据数组的指针。如果为空，则只在pulEventNumber参数中返回元素的数量。

返回值
	TSS_SUCCESS
	TSS_E_INVALID_HANDLE
	TSS_E_BAD_PARAMETER
	TSS_E_INTERNAL_ERROR

注释
Tspi_TPM_GetEvents方法为请求的事件数据分配一个内存块。必须使用Tspi_Context_FreeMemory方法释放该内存。

Tspi_TPM_GetEventLog

《TSS V1.2.pdf》 P285 4.3.4.12.3 Tspi_TPM_GetEventLog

信息说明开始
此方法提供整个事件日志。
信息说明结束

定义
	TSS_RESULT Tspi_TPM_GetEventLog
	(
        TSS_HTPM hTPM, // in
        UINT32* pulEventNumber, // out
        TSS_PCR_EVENT** prgPcrEvents // out
	);

参数
    hTPM
    	TPM对象的句柄
    pulEventNumber
    	在prgpcre参数中接收返回的事件数据结构的数量
    prgPcrEvents
    	接收指向PCR事件数据数组的指针。如果为空，则只在pulEventNumber参数中返回元素的数量。

返回值
	TSS_SUCCESS
	TSS_E_INVALID_HANDLE
	TSS_E_BAD_PARAMETER
	TSS_E_INTERNAL_ERROR

注释
Tspi_TPM_GetEventLog方法为请求的事件数据分配一个内存块。必须使用Tspi_Context_FreeMemory方法释放该内存。

Tspi_TPM_Quote

《TSS V1.2.pdf》 P286 4.3.4.12.4 Tspi_TPM_Quote

信息说明开始
该方法引用了一个TCG系统。
信息说明结束

定义
	TSS_RESULT Tspi_TPM_Quote
	(
        TSS_HTPM hTPM, // in
        TSS_HKEY hIdentKey, // in
        TSS_HPCRS hPcrComposite, // in
        TSS_VALIDATION* pValidationData // in, out
	);

参数
    hTPM
    	TPM对象的句柄
    hIdentKey
    	签名密钥对象的句柄
    hPcrComposite
    	PCR复合物的句柄;结构类型必须是TSS_PCRS_STRUCT_INFO。[在]选定的pcr中引用
    pValidationData
    	验证数据结构[IN]提供了计算签名所需的外部数据信息。在成功完成命令后，该结构提供一个包含验证数据的缓冲区和一个包含验证数据的缓冲区。

返回值
	TSS_SUCCESS
	TSS_E_INVALID_HANDLE
	TSS_E_BAD_PARAMETER
	TSS_E_INTERNAL_ERROR

注释
在调用该方法之前，必须在PcrComposite对象中设置关于应该引用哪些pcr的所需信息。在返回时，集合的每个元素都有其pcrValue集。
如果在hPcrComposite对象中使用的结构类型不是TSS_PCRS_STRUCT_INFO，那么将返回错误TSS_E_INVALID_OBJ_ACCESS。
返回签名是在TCG 1.1b主规范中定义的TCPA_QUOTE_INFO结构上计算的。
Tspi_TPM_Quote方法为请求的验证数据分配内存块。必须使用Tspi_Context_FreeMemory方法释放该内存。

Tspi_TPM_PcrExtend

《TSS V1.2.pdf》 P288 4.3.4.12.5 Tspi_TPM_PcrExtend

信息说明开始
该方法扩展PCR寄存器并写入PCR事件日志。
信息说明结束

定义
	TSS_RESULT Tspi_TPM_PcrExtend
	(
        TSS_HTPM hTPM, // in
        UINT32 ulPcrIndex, // in
        UINT32 ulPcrDataLength,   // in
        BYTE*   pbPcrData, // in
        TSS_PCR_EVENT* pPcrEvent, // in
        UINT32* pulPcrValueLength, // out
        BYTE** prgbPcrValue // out
	);

参数
    hTPM
    	TPM对象的句柄
    ulPcrIndex
    	PCR指标延长。
    ulPcrDataLength
    	参数包含要扩展的数据长度。
    pbPcrData
    	指向PCR扩展操作的数据blob的数据指针。如果pPcrEvent不为空，则该数据将用于根据节中TSS_PCR_EVENT结构的rgbPcrValue参数的描述创建的散列。如果pPcrEvent是本节中TSS_PCR_EVENT结构的参数。如果pPcrEvent为空，则该数据将被扩展到TPM中，而不会被TSP触及。
    pPcrEvent
    	指向包含事件项信息的TSS_PCR_EVENT结构的指针。如果该指针为空，则不创建任何事件项，且该函数仅执行扩展操作。如果非空，这个结构的成员将由TSP根据章节中的规则设置。
    pulPcrValueLength
    	接收prgbPcrValue参数的长度(以字节为单位)。
    prgbPcrValue
		接收一个指针，该指针指向在扩展操作之后包含PCR数据的内存块。

返回值
	TSS_SUCCESS
	TSS_E_INVALID_HANDLE
	TSS_E_BAD_PARAMETER
	TSS_E_INTERNAL_ERROR

注释
Tspi_TPM_PcrExtend方法为prgbPcrValue数据分配一个内存块。
必须使用Tspi_Context_FreeMemory方法释放该内存。

Tspi_TPM_PcrRead

《TSS V1.2.pdf》 P290 4.3.4.12.6 Tspi_TPM_PcrRead

信息说明开始
该方法读取PCR寄存器。
信息说明结束

定义
	TSS_RESULT Tspi_TPM_PcrRead
	(
        TSS_HTPM hTPM, // in
        UINT32 ulPcrIndex, // in
        UINT32* pulPcrValueLength, // out
        BYTE** prgbPcrValue // out
	);

参数
    hTPM
        TPM对象的句柄
    ulPcrIndex
    	指数PCR读。
    pulPcrValueLength
    	接收prgbPcrValue参数的长度(以字节为单位)。
    prgbPcrValue
    	接收一个指向包含PCR数据的内存块的指针。

返回值
	TSS_SUCCESS
	TSS_E_INVALID_HANDLE
	TSS_E_BAD_PARAMETER
	TSS_E_INTERNAL_ERROR

注释
Tspi_TPM_PcrRead方法为prgbPcrValue数据分配一个内存块。
必须使用Tspi_Context_FreeMemory方法释放该内存。