共用方式為


iStillImageW::GetDeviceInfo 方法 (sti.h)

IStillImage::GetDeviceInfo 方法會傳回指定之仍為映像裝置的硬體特性。

語法

HRESULT GetDeviceInfo(
  [in]  LPWSTR pwszDeviceName,
  [out] LPVOID *ppBuffer
);

參數

[in] pwszDeviceName

呼叫端提供的字串指標,代表內部裝置名稱,藉由呼叫 IStillImage::GetSTILaunchInformationIStillImage::GetDeviceList 取得。

[out] ppBuffer

接收 STI_DEVICE_INFORMATION 結構的句柄。

傳回值

如果作業成功,方法會傳回S_OK。 否則,它會傳回 stierr.h 中定義的其中一個 STIERR 前置錯誤碼。

備註

IStillImage::GetDeviceInfo 方法會傳回指定之仍然映像裝置的STI_DEVICE_INFORMATION結構。 結構內容通常用於建立使用者介面顯示。

在呼叫 IStillImage::GetDeviceInfo 之前, IStillImage COM 介面的客戶端必須呼叫 IStillImage::StiCreateInstance 以取得 IStillImage 介面指標。

當呼叫端使用 ppBuffer 所參考的STI_DEVICE_INFORMATION結構完成時,它必須呼叫 Microsoft Windows SDK localFree (檔) 中所述的 LocalFree 來解除分配緩衝區。

規格需求

需求
目標平台 桌面
標頭 sti.h (包含 Sti.h)

另請參閱

IStillImage::GetDeviceList

IStillImageW