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 |