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)