AMGetErrorTextA 函式 (errors.h)

  • 發行項

[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 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 標頭會將AMGetErrorText定義為別名，根據UNICODE預處理器常數的定義，自動選取此函式的ANSI或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
目標平台 Windows
標頭 errors.h
程式庫 一元.lib

請參閱

函式