Freigeben über

Hinzufügen von WIA-Eigenschaften zu einem WIA-Element

  • Artikel

Jedes WIA-Element enthält WIA-Eigenschaften. Eine Anwendung liest und schreibt WIA-Elementeigenschaften, um den WIA-Minitreiber zu konfigurieren. Der WIA-Dienst ruft die IWiaMiniDrv::d rvInitItemProperties-Methode einmal für jedes Element auf, auf das die Anwendung zugreift, um die Eigenschaften dieses WIA-Minitreiberelements zu initialisieren. Wenn eine Anwendung keine WIA-Eigenschaften für ein Element liest oder schreibt, wird diese Methode für dieses Element nicht aufgerufen. Der Elementkontext, auf den der pWiasContext-Parameter verweist, gibt an, welches Element mit WIA-Eigenschaften initialisiert wird.

Die IWiaMiniDrv::d rvInitItemProperties-Methode sollte die folgenden Aufgaben ausführen:

  1. Verwenden Sie die im pWiasContext-Parameter empfangenen Daten, um den Elementtyp zu bestimmen. Der WIA-Minitreiber kann die IWiaDrvItem-COM-Schnittstelle abrufen, indem er wiasGetDrvItem aufruft. Nach dem Abrufen dieser Schnittstelle kann die IWiaDrvItem::GetItemFlags-Methode aufgerufen werden, um den WIA-Elementtyp zu bestimmen.

  2. Erstellen Sie ein Array von Eigenschaftennamen und Eigenschaften-IDs, die den vollständigen Eigenschaftensatz beschreiben, der für das aktuelle Element erforderlich ist. Nach dem Erstellen dieser Arrays sollte der WIA-Minidriver die Dienstfunktion wiasSetItemPropNames aufrufen. Diese Funktion weist den WIA-Dienst an, basierend auf den erstellten Arrays einen WIA-Eigenschaftssatz zu erstellen. Diese Funktion sollte immer vor wiasWriteMultiple und wiasSetItemPropAttribs aufgerufen werden.

  3. Schreiben Sie die anfangs- oder Standardeinstellungswerte in den neu erstellten WIA-Eigenschaftssatz. Der WIA-Minidriver sollte die wiasWriteMultiple-Dienstfunktion aufrufen, um die Anfangswerte festzulegen. Diese Funktion sollte immer vor wiasSetItemPropAttribs aufgerufen werden.

  4. Schreiben Sie die gültigen Werte und Zugriffsrechte für jede Eigenschaft. Der WIA-Minitreiber sollte die wiasSetItemPropAttribs-Dienstfunktion aufrufen, um die Zugriffsrechte und gültigen Werte festzulegen.

Anwendungen sind für das Lesen (und Erneutes Lesen) aller Eigenschaften verantwortlich, von denen sie abhängen, sodass die Anwendung änderungen an den Eigenschaftswerten abfangen kann. Scanner und Kameras verfügen über eine Reihe von erforderlichen Eigenschaften. Diese Eigenschaften sind unter Informationen zu WIA-Eigenschaften aufgeführt.

Einige Eigenschaften weisen Abhängigkeiten von anderen Eigenschaften auf. Die format-Eigenschaft ist beispielsweise von der tymed-Eigenschaft abhängig. Diese Abhängigkeiten zwischen Eigenschaften werden in WIA-Eigenschaften behandelt.