IWiaMiniDrvCallBack::MiniDrvCallback-Methode (wiamindr_lh.h)
Die MiniDrvCallback-Methode stellt eine Rückrufmethode für WIA-Minidriver bereit, die während einer Rückrufdatenübertragung verwendet werden kann.
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 konstanten Wert an, der einen Rückruf status Nachricht angibt. Dieser Wert wird verwendet, um den Zweck des Rückrufs zu bestimmen, und kann einer der folgenden Werte sein:
| Nachricht | Definition |
|---|---|
| IT_MSG_DATA | Gibt an, dass der Übertragungspuffer einen Datenblock enthält. |
| IT_MSG_DATA_HEADER | Empfangen vor Datenübertragungen. Gibt an, dass der Übertragungspuffer auf eine WIA_DATA_CALLBACK_HEADER-Struktur verweist, die Elemente der Datenübertragung definiert. |
| IT_MSG_DEVICE_STATUS | Rückruf enthält nur status Informationen 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 vor der Übertragung der Vorschaudaten an die Anwendung übertragen wird. |
| IT_MSG_NEW_PAGE | Gibt an, dass die Datenübertragung einer Seite abgeschlossen ist und eine neue Seite gesendet wird. |
| IT_MSG_STATUS | Rückruf enthält nur status Informationen zur Übertragung. |
| IT_MSG_TERMINATION | Gibt an, dass die Datenübertragung abgeschlossen ist. |
[in] lStatus
Gibt die 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ät 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) im Übertragungspuffer vom Anfang des Puffers an.
[in] lLength
Gibt die Anzahl von 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 festlegen.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn der Rückruf von der Clientanwendung abgebrochen wird, gibt die Methode S_FALSE zurück. Wenn die Methode fehlschlägt, wird ein COM-Standardfehlercode zurückgegeben.
Hinweise
Die prozentual vollständigen Werte werden direkt vom Treiber gesendet. Der WIA-Dienst passt die Werte nicht an.
IT_MSG_FILE_PREVIEW_DATA_HEADER gilt für Out-of-Band-Daten. Dadurch kann die Anwendung eine Dateiübertragung durchführen, um die bandierten Daten anzuzeigen. Dies ist nützlich für Scrollscanner, die eine unbekannte Länge und keine Vorschauüberprüfung haben. Die in dieser Nachricht gemeldeten Informationen sollten genauso behandelt werden wie IT_MSG_DATA_HEADER. Wenn ein Treiber diese Meldung unterstützt, kann er während der Dateiübertragung Vorschaudaten bereitstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamindr_lh.h (wiamindr.h einschließen) |