Benutzerdefinierte und automatische Seitengrößen

Eine Anwendung kann die Seitengröße entweder durch die automatische Erkennung durch den Scanner oder über benutzerdefinierte Werte festlegen. Der von der Anwendung verwendete Ansatz wird durch die WIA_IPS_PAGE_SIZE-Eigenschaft bestimmt, die die Werte WIA_PAGE_AUTO oder WIA_PAGE_CUSTOM.

Wenn eine Anwendung WIA_IPS_PAGE_SIZE auf einen anderen Wert als WIA_PAGE_CUSTOM festlegt, sollte der WIA-Minitreiber die Werte von WIA_IPS_PAGE_WIDTH und WIA_IPS_PAGE_HEIGHT auf die Seitenabmessungen in Tausendstel Zoll (001) anpassen. Der Minidriver sollte auch die Werte von WIA_IPS_XEXTENT und WIA_IPS_YEXTENT an die Abmessungen der Seite in Pixel anpassen.

Wenn eine Erweiterungseinstellung (WIA_IPS_XEXTENT oder WIA_IPS_YEXTENT) in einen Wert geändert wird, der nicht mit der aktuellen Einstellung für die Seitengröße übereinstimmt, sollte der Minitreiber den Wert der WIA_IPS_PAGE_SIZE-Eigenschaft in WIA_PAGE_CUSTOM ändern. Der Minitreiber sollte auch WIA_IPS_PAGE_WIDTH oder WIA_IPS_PAGE_HEIGHT ändern, um der neuen Erweiterungseinstellung zuzustimmen.

Wenn eine Anwendung die WIA_IPS_PAGE_SIZE-Eigenschaft auf WIA_PAGE_CUSTOM festlegt, ist der aktuelle Auswahlbereich nicht betroffen. Der WIA-Minitreiber sollte das aktuelle Bildlayout abrufen, beginnend mit den aktuellen Einstellungen der eigenschaften WIA_IPS_XPOS und WIA_IPS_YPOS . Wenn die Einstellung für die Seitengröße dazu führt, dass sich der Auswahlbereich außerhalb des Scannerbetts befindet, muss der Minidriver die Werte der WIA_IPS_XPOS und WIA_IPS_YPOS Eigenschaften an gültige Einstellungen anpassen. Wenn die Eigenschaften WIA_IPS_PAGE_SIZE und WIA_IPS_ORIENTATION gleichzeitig festgelegt sind und ungültig sind, wenn sie in Kombination angewendet werden, sollte der Minidriver die Einstellungen der Anwendung fehlschlagen, indem ein Fehler in der IWiaMiniDrv::d rvValidateItemProperties-Methode zurückgegeben wird.

Wenn die automatische Erkennung der Seitengröße aktiviert ist, sollte der Treiber erst nach Abschluss der Übertragung der Bilddaten genaue Bilddimensionsinformationen bereitstellen. Bei streambasierten Übertragungen wird erwartet, dass der Treiber die Bilddimensionen im Bildheader am Ende der Übertragung aktualisiert. Zu Beginn einer neuen Sitzung sollte der Wert für die eigenschaft WIA_IPS_PAGE_SIZE immer auf einen anderen Wert als WIA_PAGE_AUTO festgelegt werden.

Wenn WIA_PAGE_AUTO als aktueller WIA_IPS_PAGE_SIZE-Wert festgelegt ist, muss der Treiber möglicherweise zuerst einen Bildheader übertragen, der generische Bilddimensionen enthält, dann die Bilddaten übertragen und dann zum Anfang des Übertragungsdatenstroms zurückkehren und den Bildheader mit den tatsächlichen Bildabmessungen aktualisieren (gefunden nach Abschluss der Überprüfung). und verschieben Sie den Streamindex zurück an das Ende des Datenstroms.

Wenn WIA_PAGE_AUTO festgelegt ist (vom Treiber als Standardwert ausgewählt oder von der Anwendung festgelegt), sollte die Anwendung erst versuchen, die Bilddimensionen zu verarbeiten, die der Bildheader beschreibt, bis die gesamte Bildübertragung abgeschlossen ist.

Hinweis Die Kompatibilitätsebene innerhalb des WIA-Diensts fügt dem ADF-Element, das von einem Windows XP-WIA-Gerät übersetzt wird, keine Unterstützung für WIA_IPS_PAGE_SIZE hinzu, wenn die Eigenschaft auf dem untergeordneten Element des Geräts nicht unterstützt wird. Anwendungen sollten nicht erwarten, dass ein ADF-Element diese Eigenschaft immer unterstützt, und sollten immer überprüfen, ob WIA_IPS_PAGE_SIZE zur Laufzeit unterstützt wird. (In der Regel sollten Anwendungen die Unterstützung für jede Eigenschaft überprüfen, die ausgehandelt werden soll.)