WIA-Übertragungskonstanten

Dieses Thema enthält eine Liste der Konstanten, die für WIA IStream-basierte Übertragungen verwendet werden.

Diese Konstanten sind in drei Untergruppen unterteilt:

Elementtyp

Die folgende Tabelle zeigt, welche WIA-Elementtypbits sich auf die streambasierte Datenübertragung beziehen.

Name	BESCHREIBUNG
WiaItemTypeTransfer	Dieses WIA_IPA_ITEM_FLAGS Bit sollte für alle Elemente festgelegt werden, die Daten übertragen können. Das heißt, eine Anwendung kann einen Download oder Upload für Elemente initiieren, für die dieses Bit festgelegt ist.

Die folgende Tabelle zeigt mögliche Werte für den lFlags-Parameter von IWiaTransferCallback::TransferCallback.

Name	BESCHREIBUNG
WIA_TRANSFER_MSG_STATUS	Benachrichtigt die Anwendung des Fortschritts der Übertragung. pWiaTransferParams-lPercentComplete> enthält den Prozentsatz abgeschlossen für dieses Element und die Seite, die übertragen wird.
WIA_TRANSFER_MSG_END_OF_STREAM	Benachrichtigt die Anwendung, dass keine weiteren Daten in den aktuellen Datenstrom übertragen werden können und dass der Stream möglicherweise geschlossen wird. Anschließend kann ein neuer Stream in einer Übertragung mit mehreren Elementen oder mehreren Seiten angefordert werden. Treiber senden diese Nachricht nicht manuell. Der WIA-Dienst sendet diese Nachricht automatisch, wenn der Treiber nach dem nächsten Stream fragt.
WIA_TRANSFER_MSG_END_OF_TRANSFER	Empfangen von der Anwendung am Ende der Übertragung. Der Treiber sendet diese Nachricht nicht. Der WIA-Dienst sendet diese Nachricht automatisch, nachdem die Übertragung beendet wurde (d. h. der Aufruf von IWiaMiniDrv::d rvAcquireItemData wird zurückgegeben).
WIA_TRANSFER_MSG_ERROR	Von Microsoft für die zukünftige Verwendung reserviert.
WIA_TRANSFER_MSG_DEVICE_STATUS	Gibt einen Fehler während der Übertragung an (z. B. ein Papierstau). pWiaTransferParams-hrErrorStatus> enthält den Fehler status Code.
WIA_TRANSFER_MSG_NEW_PAGE	Gibt an, dass eine neue Seite während einer mehrseitigen Übertragung übertragen wird, wenn ein Format verwendet wird, das mehrere Seiten in einer Datei unterstützt (z. B. TIFF mit mehreren Dateien).

In der folgenden Tabelle sind die Flags aufgeführt, die an IWiaMiniDrv::d rvAcquireItemData übergeben werden können.

Name	BESCHREIBUNG
WIA_MINIDRV_TRANSFER_DOWNLOAD	Gibt an, dass es sich bei der Übertragung um einen streambasierten Downloadvorgang handelt (d. a. eine Datenübertragung von einem Gerät an eine Anwendung). Anwendungen legen dieses Bit nicht direkt fest. Der WIA-Dienst legt dieses Bit fest, wenn die Anwendung IWiaTransfer::D ownload aufruft.
WIA_MINIDRV_TRANSFER_UPLOAD	Gibt an, dass es sich bei der Übertragung um einen streambasierten Uploadvorgang handelt (d. a. eine Datenübertragung von einer Anwendung auf ein Gerät). Anwendungen legen dieses Bit nicht direkt fest. Der WIA-Dienst legt dieses Bit fest, wenn die Anwendung IWiaTransfer::Upload aufruft.
WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN	Gibt an, dass der Treiber eine Ordnerübertragung durchführen soll. Wenn dieser Wert für ein Ordnerelement aufgerufen wird, fordert die Anwendung die Übertragung der untergeordneten Elemente dieses Ordners an. Dieser Wert wird festgelegt, wenn eine Anwendung eine Ordnerübertragung anfordert, indem sie den lFlags-Parameter von IWiaTransfer::D ownload auf WIA_TRANSFER_ACQUIRE_CHILDREN festlegt und der Treiber angegeben hat, dass mehrere untergeordnete Elemente in einem Scan übertragen werden können. Wenn der Treiber diese Art der Übertragung nicht ausführen kann, führt der WIA-Dienst mehrere Aufrufe an den Treiber aus, und WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN wird nicht festgelegt.