DEVICEDIALOGDATA2結構 (wiadevd.h)

發行項
02/27/2024

DEVICEDIALOGDATA2 結構包含實作自定義裝置對話框所需的所有數據。

語法

typedef struct tagDEVICEDIALOGDATA2 {
  DWORD     cbSize;
  IWiaItem2 *pIWiaItemRoot;
  DWORD     dwFlags;
  HWND      hwndParent;
  BSTR      bstrFolderName;
  BSTR      bstrFilename;
  LONG      lNumFiles;
  BSTR      *pbstrFilePaths;
  IWiaItem2 *pWiaItem;
} DEVICEDIALOGDATA2, *LPDEVICEDIALOGDATA2, *PDEVICEDIALOGDATA2;

成員

cbSize

指定這個結構的大小，以位元組為單位。

pIWiaItemRoot

指向代表應用程式專案樹狀結構中有效根專案的 IWiaItem2 介面。

dwFlags

指定由呼叫程式傳遞至 IWiaItem2：:D eviceDlg 和 IWiaDevMgr2：：GetImageDlg 的旗標。這個成員的可能值是WIA_DEVICE_DIALOG_SINGLE_IMAGE，而且WIA_DEVICE_DIALOG_USE_COMMON_UI (在头文件 Wiadef.h) 中定義。

hwndParent

指定對話框父視窗的句柄。

bstrFolderName

BSTR 類型的字串，其中包含從 WIA 專案取得之檔案的目的地資料夾名稱。

bstrFilename

BSTR 類型的字串，其中包含要用於從 WIA 專案傳送至 bstrFolderName 所指定目的地資料夾的檔案名範本。您可以將其他字元附加至檔名範本，以建立任意數目的唯一檔名。如需檔名範本的詳細資訊，請參閱 PathMakeUniqueName 和 PathYetAnotherMakeUniqueName。

lNumFiles

寫入 pbstrFilePaths 陣列的字串數目。

pbstrFilePaths

BSTR 指標陣列的指標。每個陣列元素都會指向 BSTR ，其中包含已成功傳送至 bstrFolderName 所識別之資料夾的檔案目的地名稱。方法必須配置此成員的記憶體。如需詳細資訊，請參閱下列一節。

pWiaItem

WIA 專案的 IWiaItem2 介面指標，該介面會將數據傳輸至 bstrFilePaths 陣列中名為的檔案或檔案。

備註

IWiaUIExtension2：:D eviceDialog 方法會使用DEVICEDIALOGDATA2結構。

DeviceDialog 方法必須呼叫 CoTaskMemAlloc 函式來配置 pbstrFilePaths 中指定的 BSTR 指標數位，而且必須呼叫 SysAllocString 函式來配置數位所指向的每個字串。呼叫程式負責釋放指標數位和字串的記憶體。

若要保留 IWiaItem2 介面的參考， DeviceDialog 方法必須在介面上呼叫 IUnknown：：AddRef 方法，再從呼叫傳回。

若要存取 IWiaItem2 物件屬性的相關信息， DeviceDialog 方法必須查詢物件以取得其 IWiaPropertyStorage 介面。若要從 IWiaItem2 物件傳輸數據， DeviceDialog 方法必須查詢物件以取得其 IWiaTransfer 介面。