iStillImageW::GetDeviceInfo 方法 (sti.h)
IStillImage::GetDeviceInfo 方法會傳回指定之仍為映像裝置的硬體特性。
語法
HRESULT GetDeviceInfo(
[in] LPWSTR pwszDeviceName,
[out] LPVOID *ppBuffer
);
參數
[in] pwszDeviceName
呼叫端提供的字串指標,代表內部裝置名稱,藉由呼叫 IStillImage::GetSTILaunchInformation 或 IStillImage::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) |