Funzione di analisi (wiamicro.h)
La funzione Analisi legge i dati dal dispositivo e restituisce i dati al driver WIA Flatbed.
Sintassi
WIAMICRO_API HRESULT Scan(
[in, out] PSCANINFO pScanInfo,
LONG lPhase,
[out] PBYTE pBuffer,
LONG lLength,
[out] LONG *plReceived
);
Parametri
[in, out] pScanInfo
Specifica la struttura SCANINFO che rappresenta le impostazioni del microdriver. Questo viene archiviato dal driver WIA Flatbed per garantire che le impostazioni tra il microdriver e il driver WIA Flatbed siano sincronizzate.
lPhase
Specifica la fase di analisi richiesta. Questo parametro può essere impostato su uno dei valori seguenti.
| Valore | Significato |
|---|---|
| SCAN_FIRST | Questo segnala la prima fase dell'analisi. Il microdriver esegue tre attività: inizializza il dispositivo, usa i dati nella struttura SCANINFO per configurare l'analisi( ad esempio, impostare la risoluzione, la posizione iniziale, la larghezza e l'altezza del dispositivo) e avvia l'analisi. I dati devono essere restituiti da questa chiamata. I dati devono essere inseriti nel buffer puntati da pBuffer e il parametro pReceived deve essere impostato sulla quantità di dati inseriti nel buffer. |
| SCAN_NEXT | Questa operazione verrà ripetutamente chiamata durante il trasferimento dei dati. I dati devono essere inseriti nel buffer puntati da pBuffer e il parametro pReceived deve essere impostato sulla quantità di dati inseriti nel buffer. |
| SCAN_FINISHED | Verrà chiamato alla fine dell'analisi per terminare il processo di analisi. Non è necessario trasferire dati. SCAN_FINISHED verrà sempre chiamato anche se l'utente annulla l'analisi. Il microdriver deve interrompere il trasferimento dei dati e lo scanner deve essere reimpostato in modo che sia pronto per l'analisi successiva. I dati restituiti da questa funzione devono essere in formato non elaborato senza intestazione. I dati possono essere compressi o planari, allineati o non idonei e in ordine RGB o BGR. Impostare i membri RawDataFormat, RawPixelOrder e bNeedDataAlignment della struttura SCANINFO in modo appropriato in risposta al comando CMD_INITIALIZE. |
[out] pBuffer
Specifica il buffer che verrà riempito con dati analizzati dal microdriver. Questo buffer viene allocato dal driver flat WIA e deve essere almeno lLength byte di lunghezza.
lLength
Specifica la quantità richiesta di dati che verranno analizzate. Il microdriver non deve mai riempire il buffer a cui fa riferimento pBuffer.
[out] plReceived
Specifica la quantità di dati effettivamente analizzata in pBuffer. Questo valore non deve mai superare il valore di lLength, ma può essere minore.
Valore restituito
Se la funzione ha esito positivo, restituisce S_OK. Se la funzione ha esito negativo, restituisce un codice di errore COM standard.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamicro.h (includere Wiamicro.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |