WIA 項目への WIA プロパティを追加する
各 WIA 項目には、WIA プロパティが含まれています。 アプリケーションは、WIA ミニドライバーを構成する WIA 項目のプロパティを読み取り、書き込みます。 WIA サービスは、アプリケーションがアクセスするすべての項目に対して IWiaMiniDrv::drvInitItemProperties メソッドを 1 回呼び出して、その WIA ミニドライバー項目のプロパティを初期化します。 アプリケーションが項目の WIA プロパティの読み取りまたは書き込みを行わない場合、このメソッドはその項目に対して呼び出されません。 pWiasContext パラメーターが指す項目コンテキストは、WIA プロパティを使用して初期化される項目を示します。
IWiaMiniDrv::drvInitItemProperties メソッドは、次のタスクを実行する必要があります。
pWiasContext パラメーターで受信したデータを使用して、項目の種類を確認します。 WIA ミニドライバーは wiasGetDrvItem を呼び出すことによって IWiaDrvItem COM インターフェイスを取得できます。 このインターフェイスを取得した後、 IWiaDrvItem::GetItemFlags メソッドを呼び出して WIA 項目の種類を確認できます。
現在のアイテムに必要な完全なプロパティ セットを記述するプロパティ名とプロパティ ID の配列を作成します。 これらの配列を作成した後、WIA ミニドライバーは wiasSetItemPropNames サービス関数を呼び出す必要があります。 この関数は、作成された配列に基づいて WIA プロパティ セットを構築するように WIA サービスに指示します。 この関数は wiasWriteMultiple と wiasSetItemPropAttribs の前に常に呼び出す必要があります。
新しく作成された WIA プロパティ セットに、初期または既定の設定値を書き込みます。 WIA ミニドライバーは wiasWriteMultiple サービス関数を呼び出して初期値を設定する必要があります。 この関数は wiasSetItemPropAttribs の前に常に 呼び出す必要があります。
各プロパティの有効な値とアクセス権を書き込みます。 WIA ミニドライバーは wiasSetItemPropAttribs サービス関数を呼び出して、アクセス権と有効な値を設定する必要があります。
アプリケーションは、依存するすべてのプロパティの読み取り (および再読み取り) を担当するため、アプリケーションはプロパティ値の変更をキャッチできます。 スキャナーとカメラには、一連の必須プロパティがあります。 これらのプロパティは、 「WIA プロパティについて」 に一覧表示されます。
一部のプロパティは、他のプロパティに依存しています。 たとえば format プロパティは tymed プロパティに依存します。 これらのプロパティ間の依存関係については WIA プロパティ で 説明します。