共用方式為


呼叫 SetupWriteTextLogInfLine

應用程式可以呼叫 SetupWriteTextLogInfLine,在 SetupAPI 文字記錄 中寫入包含指定 INF 檔案行文字的記錄項目。

若要呼叫 SetupWriteTextLogInfLine,應用程式會提供下列資訊:

  • 呼叫 SetupGetThreadLogToken 或其中一個系統定義記錄令牌,在文字記錄檔中取得的 區段記錄令牌。 如果記錄令牌與文字記錄區段相關聯,SetupWriteTextLogInfLine 會在該區段中寫入記錄條目。 否則,SetupWriteTextLogInfLine 會將記錄專案新增至未包含在文字記錄區段中的記錄檔某部分。

    此外,SetupWriteTextLogInfLine 是否會寫入日誌項目,以及該日誌項目會寫入哪個文字日誌,取決於系統定義的日誌標記值。

    如需有關日誌代幣的更多資訊,請參閱 設定和取得執行緒的日誌代幣

  • 旗標值為一組系統定義的常數的位元 OR 操作,這些常數指定了事件層級、縮排深度,以及是否包含時間戳。 設定文字記錄檔的事件層級中所述。

    如果為文字記錄檔設定的事件層級大於或等於項目的事件層級,SetupWriteTextLogInfLine 會在文字記錄檔中寫入一個記錄項目。 否則,SetupWriteTextLogInfLine 不會在文字記錄檔中寫入記錄項目。 藉由使用縮排,可以排列格式化的訊息,讓區段中的資訊更容易閱讀和瞭解。

    如需詳細資訊,請參閱 撰寫縮排日誌條目

  • 包含 INF 檔案行的 INF 檔案句柄的參考。

  • INF 檔案行的上下文。

SetupWriteTextLogInfLine 會以下列格式寫入一條記錄項目:

entry_prefix time_stampinf:indentation inf-line-textinf-file-namelineline-number

地點:

  • entry_prefix時間戳縮排欄位與文字記錄區段本文格式中所述的欄位相同。

  • inf: 欄位指定 TXTLOG_INF 事件類別。 事件類別描述在啟用文字日誌的事件類別中。

  • inf-line-text 字段包含指定 INF 檔案行的文字。

  • inf-file-name 欄位包含包含指定 INF 檔案行的 INF 檔名。

  • 欄位表示接下來的內容是 INF 檔案中的行號。

  • 行號欄位包含 INF 檔案中指定行的行號。

下列範例示範應用程式如何在文字記錄檔中記錄 INF 行的文字。 此範例中的 INF 行是 INF AddReg 行。 應用程式會呼叫 SetupWriteTextLogInfLine,並提供下列輸入參數值:

  • LogToken 被設為 SetupGetThreadLogToken 傳回的記錄令牌,或系統定義的 記錄令牌

  • LogFlags 會設定為 TXTLOG_DETAILS。 此範例不包含時間戳或變更縮排深度。 在此範例中,縮排深度為五個等寬字體空格。

  • InfHandle 設定為 INF 檔案 hidserv.inf 的句柄。呼叫 Platform SDK 中記載的 SetupOpenInfFile 函式,以取得此句柄。

  • 環境 被設為包含 "AddReg=HidServ_AddService_AddReg" 文字的 INF 檔案行的 INF 檔案環境。透過呼叫 Platform SDK 中記錄的 SetupFindXxxLine 函數,以取得該行的 INF 檔案環境。

LogTokenLogFlags 的值會以與 SetupWriteTextLog 所述的相同方式影響 SetupWriteTextLogInfLine 的操作。 此外, SetupWriteTextLogInfLine 會使用事件目錄TXTLOG_INF。

在此範例中,下列顯示 SetupWriteTextLogInfLine 將寫入文字記錄檔的記錄項目類型:

   inf:      AddReg=HidServ_AddService_AddReg  (hidserv.inf line 98)