struktur DEVICEDIALOGDATA2 (wiadevd.h)

Artikel
08/08/2023

Struktur DEVICEDIALOGDATA2 berisi semua data yang diperlukan untuk mengimplementasikan dialog perangkat kustom.

Sintaks

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

Anggota

cbSize

Menentukan ukuran, dalam byte, dari struktur ini.

pIWiaItemRoot

Menunjuk ke antarmuka IWiaItem2 yang mewakili item akar yang valid di pohon item aplikasi.

dwFlags

Menentukan bendera yang diteruskan ke IWiaItem2::D eviceDlg dan IWiaDevMgr2::GetImageDlg oleh program panggilan. Nilai yang mungkin untuk anggota ini adalah WIA_DEVICE_DIALOG_SINGLE_IMAGE dan WIA_DEVICE_DIALOG_USE_COMMON_UI (ditentukan dalam file header Wiadef.h).

hwndParent

Menentukan handel ke jendela induk dialog.

bstrFolderName

String jenis BSTR yang berisi nama folder tujuan tempat file yang diperoleh dari item WIA ditransfer.

bstrFilename

String jenis BSTR yang berisi templat nama file yang akan digunakan untuk file yang ditransfer dari item WIA ke folder tujuan yang ditunjuk oleh bstrFolderName. Jumlah arbitrer nama file unik dapat dibuat dengan menambahkan karakter tambahan ke templat nama file. Untuk informasi selengkapnya tentang templat nama file, lihat PathMakeUniqueName dan PathYetAnotherMakeUniqueName.

lNumFiles

Jumlah string yang ditulis ke array pbstrFilePaths .

pbstrFilePaths

Arahkan ke array pointer BSTR . Setiap elemen array menunjuk ke BSTR yang berisi nama tujuan file yang berhasil ditransfer ke folder yang diidentifikasi oleh bstrFolderName. Metode harus mengalokasikan penyimpanan untuk anggota ini. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

pWiaItem

Arahkan ke antarmuka IWiaItem2 dari item WIA yang mentransfer data ke file atau file bernama dalam array bstrFilePaths .

Keterangan

Struktur DEVICEDIALOGDATA2 digunakan oleh metode IWiaUIExtension2::D eviceDialog .

Metode DeviceDialog harus mengalokasikan array pointer BSTR yang ditentukan dalam pbstrFilePaths dengan memanggil fungsi CoTaskMemAlloc , dan harus mengalokasikan setiap string yang dialokasikan oleh array dengan memanggil fungsi SysAllocString . Program panggilan bertanggung jawab untuk membebaskan penyimpanan untuk array penunjuk dan string.

Untuk mempertahankan referensi ke antarmuka IWiaItem2 , metode DeviceDialog harus memanggil metode IUnknown::AddRef pada antarmuka sebelum kembali dari panggilan.

Untuk mengakses informasi tentang properti objek IWiaItem2 , metode DeviceDialog harus meminta objek untuk mendapatkan antarmuka IWiaPropertyStorage-nya . Untuk mentransfer data dari objek IWiaItem2 , metode DeviceDialog harus meminta objek untuk mendapatkan antarmuka IWiaTransfer-nya .