DEVICEDIALOGDATA 構造体 (wiadevd.h)

DEVICEDIALOGDATA 構造体には、カスタム デバイス ダイアログを実装するために必要なすべてのデータが含まれています。

構文

typedef struct tagDEVICEDIALOGDATA {
  DWORD    cbSize;
  HWND     hwndParent;
  IWiaItem *pIWiaItemRoot;
  DWORD    dwFlags;
  LONG     lIntent;
  LONG     lItemCount;
  IWiaItem **ppWiaItems;
} DEVICEDIALOGDATA, *LPDEVICEDIALOGDATA, *PDEVICEDIALOGDATA;

メンバーズ

cbSize

この構造体のサイズをバイト単位で指定します。

hwndParent

ダイアログの親ウィンドウへのハンドルを指定します。

pIWiaItemRoot

アプリケーション項目ツリーの有効なルート項目を表す IWiaItem インターフェイスを指します。 このインターフェイスの詳細については、Windows SDK のドキュメントを参照してください。

dwFlags

呼び出し元のプログラム IWiaItem::D eviceDlg および IWiaDevMgr::GetImageDlg に渡されるフラグを指定します。 これらのメソッドについては、Windows SDK のドキュメントで説明されています。 このメンバーに指定できる値は、WIA_DEVICE_DIALOG_SINGLE_IMAGEとWIA_DEVICE_DIALOG_USE_COMMON_UIです (Wiadef.hで定義されています)。

lIntent

呼び出し元のプログラムによって IWiaItem::D eviceDlg および IWiaDevMgr::GetImageDlg に渡される意図を指定します (Windows SDK のドキュメントを参照)。

lItemCount

ppIWiaItems ポイント 配列内の項目の数を指定します。

ppWiaItems

IWiaItem インターフェイス ポインターの配列。 配列は次の値を必要と

備考

DEVICEDIALOGDATA 構造体は、IWiaUIExtension::D eviceDialog メソッドによって使用されます。

ppIWiaItems で指定された配列は、CoTaskMemAllocを使用して割り当てる必要があります。 配列に示されているすべてのインターフェイス ポインターは、AddRef COM メソッドを使用して初期化する必要があります。 これらの関数の説明については、Windows SDK のドキュメントを参照してください。

IWiaPropertyStorage インターフェイスは、IWiaItem オブジェクトのプロパティに関する情報にアクセスするために使用されます。 アプリケーションは、IWiaPropertyStorage インターフェイスを取得するために、項目に対してクエリを実行する必要があります。 このインターフェイスの説明については、Windows SDK のドキュメントを参照してください。

必要条件

要件	価値
ヘッダー	wiadevd.h (Wiadevd.h を含む)

関連項目

IWiaUIExtension::D eviceDialog