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 のドキュメントを参照してください。

要件

こちらもご覧ください

IWiaUIExtension::D eviceDialog