共用方式為


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)

另請參閱

IStillImage::GetDeviceInfo

IStillImageW