IWICBitmapCodecInfo：：GetDeviceModels 方法 (wincodec.h)

擷取與編解碼器相關聯的裝置型號逗號分隔清單。

語法

HRESULT GetDeviceModels(
  [in]      UINT  cchDeviceModels,
  [in, out] WCHAR *wzDeviceModels,
  [in, out] UINT  *pcchActual
);

參數

[in] cchDeviceModels

類型： UINT

裝置模型緩衝區的大小。 在第一次呼叫時使用 0 來判斷所需的緩衝區大小。

[in, out] wzDeviceModels

類型： WCHAR*

接收與編解碼器相關聯的裝置型號名稱逗號分隔清單。 在第一次呼叫時使用 NULL 來判斷所需的緩衝區大小。

[in, out] pcchActual

類型： UINT*

擷取所有裝置型號名稱所需的實際緩衝區大小。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

這個方法的使用模式是兩個呼叫程式。 第一次呼叫會擷取擷取完整色彩管理版本號碼所需的緩衝區大小，方法是將 cchDeviceModels 設定為 0 ， 而 wzDeviceModels 設定為 NULL 。 此呼叫會將 pcchActual 設定為所需的緩衝區大小。 決定所需的緩衝區大小之後，將cchDeviceModels設定為緩衝區大小的第二個GetDeviceModels呼叫，而 wzDeviceModels設定為適當大小的緩衝區將會擷取像素格式。

規格需求

最低支援的用戶端	Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	wincodec.h
程式庫	Windowscodecs.lib
Dll	Windowscodecs.dll