共用方式為

AMGetErrorTextA 函式 （errors.h）

  • 發行項

[與此頁面相關聯的功能，DirectShow是舊版功能。 它已被 MediaPlayer、imfMediaEngine 取代，並在媒體基金會音訊/視訊擷取。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft強烈建議新程式代碼盡可能在媒體 基礎中使用 MediaPlayer、IMFMediaEngine 和 音訊/視訊擷取，而不是 DirectShow。 Microsoft建議使用舊版 API 的現有程式代碼，盡可能改寫成使用新的 API。]

AMGetErrorText 函式會使用目前的語言設定，擷取指定傳回碼的錯誤訊息。

此函式會將 HRESULT 傳回碼轉換為錯誤訊息。 常數MAX_ERROR_TEXT_LEN會指定錯誤訊息中的字元數上限。

語法

AMOVIEAPI DWORD AMGetErrorTextA(
  HRESULT hr,
  LPSTR   pbuffer,
  DWORD   MaxLen
);

參數

hr

HRESULT 值。

pbuffer

接收錯誤訊息之字元緩衝區的指標。

MaxLen

pBuffer 中的字元數。

傳回值

傳回緩衝區中傳回的字元數，如果發生錯誤則傳回零。

言論

注意

errors.h 標頭會根據 UNICODE 預處理器常數的定義，將 AMGetErrorText 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
目標平臺 窗戶
標頭 errors.h
連結庫 Quar.lib

另請參閱

函式