DEVICEDIALOGDATA2結構（wiadevd.h）

發行項
02/07/2025

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 函式來設定 pbstrFilePath s 中指定的 BSTR 指標陣列，而且必須呼叫 SysAllocString 函式來配置數位所指向的每個字元串。呼叫程式負責釋放指標數位和字串的記憶體。

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

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