Freigeben über


WIA-Übertragungskonstanten

This topic contains a list of the constants that are used for WIA IStream-based transfers.

Diese Konstanten sind in drei Untergruppen unterteilt:

  • Item type

  • Callback messages

  • Transfer flags

Item type

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

Name Description
WiaItemTypeTransfer This WIA_IPA_ITEM_FLAGS bit should be set on all items that are capable of transferring data; that is, an application can initiate a download or upload on items that have this bit set.

Callback messages

The following table shows possible values for the lFlags parameter of IWiaTransferCallback::TransferCallback.

Name Description
WIA_TRANSFER_MSG_STATUS Benachrichtigt die Anwendung des Fortschritts der Übertragung.

pWiaTransferParams->lPercentComplete contains the percent complete for this item and the page that is being transferred.
WIA_TRANSFER_MSG_END_OF_STREAM Benachrichtigt die Anwendung, dass keine weiteren Daten an den aktuellen Datenstrom übertragen werden und dass der Datenstrom geschlossen werden kann.

Ein neuer Datenstrom kann später in einer mehrstufigen oder mehrseitigen Übertragung angefordert werden.

Treiber senden diese Nachricht nicht manuell. Der WIA-Dienst sendet diese Nachricht automatisch, wenn der Treiber nach dem nächsten Datenstrom fragt.
WIA_TRANSFER_MSG_END_OF_TRANSFER Empfangen von der Bewerbung am Ende der Übertragung.

Der Treiber sendet diese Nachricht nicht. The WIA service will send this message automatically after the transfer has ended (that is, the call to IWiaMiniDrv::drvAcquireItemData returns).
WIA_TRANSFER_MSG_ERROR Reserviert von Microsoft für die zukünftige Verwendung.
WIA_TRANSFER_MSG_DEVICE_STATUS Gibt einen Fehler während der Übertragung an (z. B. ein Papierstau).

pWiaTransferParams->hrErrorStatus contains the error 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 (z. B. Multifile TIFF) unterstützt.

Transfer flags

The following table shows the flags that may be passed into IWiaMiniDrv::drvAcquireItemData.

Name Description
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 zu einer Anwendung).

Anwendungen legen dieses Bit nicht direkt fest. The WIA service sets this bit if the application calls IWiaTransfer::Download.
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. The WIA service sets this bit if the application calls IWiaTransfer::Upload.
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 an, die untergeordneten Elemente dieses Ordners zu übertragen.

This value will be set if an application requests a folder transfer by setting the lFlags parameter of IWiaTransfer::Download to WIA_TRANSFER_ACQUIRE_CHILDREN and the driver has specified that it can transfer multiple children in one scan. If the driver cannot perform this type of transfer, the WIA service will make multiple calls into the driver and WIA_MINIDRV_TRANSFER_ACQUIRE_CHILDREN will not be set.