Metodo IWiaMiniDrvCallBack::MiniDrvCallback (wiamindr_lh.h)

Articolo
08/08/2023

Il metodo MiniDrvCallback fornisce un metodo di callback per i minidriver WIA da usare durante il trasferimento dei dati di callback.

Sintassi

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
);

Parametri

[in] lReason

Specifica un valore costante che designa un messaggio di stato di callback. Questo valore viene usato per determinare lo scopo del callback e può essere uno dei valori seguenti:

Messaggio	Definizione
IT_MSG_DATA	Indica che il buffer di trasferimento contiene un blocco di dati.
IT_MSG_DATA_HEADER	Ricevuta prima dei trasferimenti di dati. Indica che il buffer di trasferimento punta a una struttura WIA_DATA_CALLBACK_HEADER che definisce gli elementi del trasferimento dei dati.
IT_MSG_DEVICE_STATUS	Il callback contiene solo informazioni sullo stato del dispositivo.
IT_MSG_FILE_PREVIEW_DATA	Indica che i dati di anteprima vengono trasferiti all'applicazione.
IT_MSG_FILE_PREVIEW_DATA_HEADER	Indica che un'intestazione viene trasferita all'applicazione, prima del trasferimento dei dati di anteprima.
IT_MSG_NEW_PAGE	Indica che il trasferimento dei dati di una pagina è completo e viene inviata una nuova pagina.
IT_MSG_STATUS	Il callback contiene solo informazioni sullo stato del trasferimento.
IT_MSG_TERMINATION	Indica che il trasferimento dei dati è stato completato.

[in] lStatus

Specifica lo stato del trasferimento. Questo parametro è un OR bit per bit dei valori seguenti:

Stato	Definizione
IT_STATUS_TRANSFER_FROM_DEVICE	Trasferimento di dati dal dispositivo.
IT_STATUS_PROCESSING_DATA	Il dispositivo e/o il minidriver elaborano i dati.
IT_STATUS_TRANSFER_TO_CLIENT	Trasferimento di dati dal minidriver al servizio WIA.

[in] lPercentComplete

Specifica la percentuale corrente di dati trasferiti.

[in] lOffset

Specifica l'offset corrente (in byte) nel buffer di trasferimento dall'inizio del buffer.

[in] lLength

Specifica il numero di byte contenuti nel trasferimento.

[in] pTranCtx

Punta a una struttura MINIDRV_TRANSFER_CONTEXT contenente i valori di trasferimento dei dati.

[in] lReserved

Riservato. Imposta su zero.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK. Se il callback viene annullato dall'applicazione client, il metodo restituisce S_FALSE. Se il metodo ha esito negativo, restituisce un codice di errore COM standard.

Commenti

I valori completi percentuale vengono inviati direttamente dal driver. Il servizio WIA non modifica i valori.

IT_MSG_FILE_PREVIEW_DATA_HEADER è per i dati fuori banda. Ciò consente all'applicazione di eseguire un trasferimento di file per visualizzare i dati con banda. Questo è utile per gli scanner a scorrimento che hanno una lunghezza sconosciuta e nessuna analisi di anteprima. Le informazioni segnalate in questo messaggio devono essere trattate come IT_MSG_DATA_HEADER. Se un driver supporta questo messaggio, può fornire dati di anteprima durante il trasferimento di file.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	wiamindr_lh.h (includere Wiamindr.h)

Vedi anche

IWiaMiniDrvCallBack

MINIDRV_TRANSFER_CONTEXT

Condividi tramite