SetupWriteTextLogInfLine 函式 (setupapi.h)

SetupWriteTextLogInfLine 函式會在 SetupAPI 文字記錄檔中寫入記錄專案，其中包含指定 INF 檔案行的文字。

語法

WINSETUPAPI VOID SetupWriteTextLogInfLine(
  [in] SP_LOG_TOKEN LogToken,
  [in] DWORD        Flags,
  [in] HINF         InfHandle,
  [in] PINFCONTEXT  Context
);

參數

[in] LogToken

系統定義的 記錄令牌 ，或 由 SetupGetThreadLogToken 傳回的記錄令牌。

[in] Flags

類型為 DWORD 的值，其為旗標值的位 OR，指定下列專案：

• 記錄專案的事件層級。 可為記錄專案指定的事件層級，與可針對文字記錄啟用的事件層級相同。 如需事件層級旗標的清單，請參閱 設定 SetupAPI 文字記錄的事件層級。
• 是否要在記錄專案中包含時間戳。 時間戳旗標值是TXTLOG_TIMESTAMP。
• 如果有任何變更，則變更為區段的縮排深度和目前的記錄專案。 如需如何使用縮排旗標的資訊，請參閱 撰寫縮排記錄專案。

[in] InfHandle

INF 檔案的句柄，其中包含要寫入文字記錄檔的文字行。 呼叫 SetupOpenInfFile 以取得 INF 檔案的句柄，其記載於平臺 SDK 中。

[in] Context

INF 檔案內容的指標，指定要寫入文字記錄檔的文字行。 呼叫 SetupFindXxxLine 函式可取得行的 INF 檔案內容。 如需 INF 檔案和 INF 檔案內容的相關信息，請參閱平臺 SDK 中有關使用 INF 檔案、取得 INF 檔案內容和 INFCONTEXT 結構的資訊。

傳回值

無

備註

SetupWriteTextLogInfLine 會以下列格式寫入記錄專案：

entry-prefixtime-stampinf：indentationinf-line-text (inf-file-name行號行號)

其中：

• 專案前置詞和時間戳欄位與文字記錄區段本文格式中所述的欄位相同。
• inf-line-text 字段包含指定 INF 檔案行的文字。
• inf-file-name 欄位包含包含指定 INF 檔案行的 INF 檔名。
• 行 號 欄位包含 INF 檔案中指定行的行號。

如需在 SetupAPI 文字記錄中寫入記錄專案的一般資訊，請參閱 SetupAPI Logging (Windows Vista) 。

如需 SetupWriteTextLogInfLine 作業的詳細資訊，請參閱 呼叫 SetupWriteTextLogInfLine。

如需各種記錄令牌類型的詳細資訊，請參閱 記錄令牌。

如需使用記錄令牌的詳細資訊，請參閱 設定和取得線程的記錄令牌。

規格需求

另請參閱

SetupGetThreadLogToken

SetupWriteTextLog

SetupWriteTextLogError