iStillImageW::GetDeviceList 方法 (sti.h)
IStillImage::GetDeviceList 方法會傳回所有已安裝之仍為映像裝置的硬體特性。
語法
HRESULT GetDeviceList(
DWORD dwType,
DWORD dwFlags,
[out] DWORD *pdwItemsReturned,
[out] LPVOID *ppBuffer
);
參數
dwType
保留的參數,請使用 NULL。
dwFlags
保留的參數,請使用 NULL。
[out] pdwItemsReturned
接收 ppBuffer 所參考之緩衝區中提供的STI_DEVICE_INFORMATION結構數目。
[out] ppBuffer
接收 STI 配置緩衝區的句柄。 此緩衝區將包含 STI_DEVICE_INFORMATION 結構的陣列。
傳回值
如果作業成功,方法會傳回S_OK。 否則,它會傳回 stierr.h 中定義的其中一個 STIERR 前置錯誤碼。
備註
IStillImage::GetDeviceList 方法會針對每個已安裝的仍然映像裝置傳回STI_DEVICE_INFORMATION結構。 結構內容通常用於建立使用者介面顯示,以及尋找裝置的內部名稱。
呼叫 IStillImage::GetDeviceList 之前, IStillImage COM 介面的客戶端必須呼叫 IStillImage::StiCreateInstance 以取得 IStillImage 介面指標。
當呼叫端使用 ppBuffer 所參考STI_DEVICE_INFORMATION結構的陣列完成時,它必須呼叫 Microsoft Windows SDK 檔) 中所述的 LocalFree (解除分配陣列。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | sti.h (包含 Sti.h) |