IWiaMiniDrvCallBack::MiniDrvCallback-Methode (wiamindr_lh.h)

Artikel
02/07/2025

Die MiniDrvCallback--Methode stellt eine Rückrufmethode für WIA-Minidriver bereit, die während einer Rückrufdatenübertragung verwendet werden können.

Syntax

HRESULT MiniDrvCallback(
  [in] LONG                      lReason,
  [in] LONG                      lStatus,
  [in] LONG                      lPercentComplete,
  [in] LONG                      lOffset,
  [in] LONG                      lLength,
  [in] PMINIDRV_TRANSFER_CONTEXT pTranCtx,
  [in] LONG                      lReserved
);

Parameter

[in] lReason

Gibt einen Konstantenwert an, der eine Rückrufstatusmeldung angibt. Dieser Wert wird verwendet, um den Zweck des Rückrufs zu bestimmen und kann einen der folgenden Werte sein:

Nachricht	Definition
IT_MSG_DATA	Gibt an, dass der Übertragungspuffer einen Datenblock enthält.
IT_MSG_DATA_HEADER	Empfangen vor jeder Datenübertragung. Gibt an, dass der Übertragungspuffer auf eine WIA_DATA_CALLBACK_HEADER Struktur verweist, die Elemente der Datenübertragung definiert.
IT_MSG_DEVICE_STATUS	Der Rückruf enthält nur Statusinformationen zum Gerät.
IT_MSG_FILE_PREVIEW_DATA	Gibt an, dass Vorschaudaten an die Anwendung übertragen werden.
IT_MSG_FILE_PREVIEW_DATA_HEADER	Gibt an, dass ein Header an die Anwendung übertragen wird, bevor die Vorschaudaten übertragen werden.
IT_MSG_NEW_PAGE	Gibt an, dass die Datenübertragung einer Seite abgeschlossen ist und eine neue Seite gesendet wird.
IT_MSG_STATUS	Der Rückruf enthält nur Statusinformationen zur Übertragung.
IT_MSG_TERMINATION	Gibt an, dass die Datenübertragung abgeschlossen ist.

[in] lStatus

Gibt den Status der Übertragung an. Dieser Parameter ist ein bitweiser OR der folgenden Werte:

Status	Definition
IT_STATUS_TRANSFER_FROM_DEVICE	Übertragen von Daten vom Gerät.
IT_STATUS_PROCESSING_DATA	Geräte und/oder Minidriver verarbeiten die Daten.
IT_STATUS_TRANSFER_TO_CLIENT	Übertragen von Daten vom Minidriver an den WIA-Dienst.

[in] lPercentComplete

Gibt den aktuellen Prozentsatz der übertragenen Daten an.

[in] lOffset

Gibt den aktuellen Offset (in Bytes) in den Übertragungspuffer vom Anfang des Puffers an.

[in] lLength

Gibt die Anzahl der Bytes an, die in der Übertragung enthalten sind.

[in] pTranCtx

Verweist auf eine MINIDRV_TRANSFER_CONTEXT Struktur, die die Datenübertragungswerte enthält.

[in] lReserved

Reserviert. Auf Null festgelegt.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OKzurückgegeben. Wenn der Rückruf von der Clientanwendung abgebrochen wird, gibt die Methode S_FALSEzurück. Wenn die Methode fehlschlägt, wird ein standardmäßiger COM-Fehlercode zurückgegeben.

Bemerkungen

Die Prozent-Vollständig-Werte werden direkt vom Treiber gesendet. Der WIA-Dienst passt die Werte nicht an.

IT_MSG_FILE_PREVIEW_DATA_HEADER ist für Out-of-Band-Daten vorgesehen. Dadurch kann die Anwendung eine Dateiübertragung durchführen, um die gebänderten Daten anzuzeigen. Dies ist nützlich für Scroll-gefütterte Scanner mit unbekannter Länge und ohne Vorschauscan. Die in dieser Nachricht gemeldeten Informationen sollten mit IT_MSG_DATA_HEADERbehandelt werden. Wenn ein Treiber diese Meldung unterstützt, kann er während der Dateiübertragung Vorschaudaten bereitstellen.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	wiamindr_lh.h (include Wiamindr.h)

Siehe auch

IWiaMiniDrvCallBack-

MINIDRV_TRANSFER_CONTEXT

Freigeben über