IDiscFormat2::IsCurrentMediaSupported 方法 (imapi2.h)

判斷支援錄製器中的目前媒體是否支援指定的格式。

語法

HRESULT IsCurrentMediaSupported(
  [in]  IDiscRecorder2 *recorder,
  [out] VARIANT_BOOL   *value
);

參數

[in] recorder

要測試之錄製器的 IDiscRecorder2 介面。

[out] value

如果錄製器中的媒體支援指定的格式,則會VARIANT_TRUE;否則,VARIANT_FALSE。

注意 VARIANT_TRUE也表示 IsDiscRecorderSupported 的結果VARIANT_TRUE。
 

傳回值

S_OK或S_FALSE會在成功時傳回,但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:

傳回碼 Description
E_POINTER
指標無效。

值:0x80004003

E_IMAPI_RECORDER_MEDIA_NO_MEDIA
裝置中沒有媒體。

(HRESULT) 0xC0AA0202

 
注意 目前,當裝置中沒有媒體時,Windows Vista 會傳回 S_OKVARIANT_FALSE ,而 windows 7 會傳回 E_IMAPI_RECORDER_MEDIA_NO_MEDIAVARIANT_FALSE
 

規格需求

需求
最低支援的用戶端 Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 imapi2.h

另請參閱

IDiscFormat2

IDiscFormat2::IsDiscRecorderSupported