struttura MINIDRV_TRANSFER_CONTEXT (wiamindr_lh.h)

La struttura MINIDRV_TRANSFER_CONTEXT viene usata per archiviare l'immagine e altre informazioni necessarie per il trasferimento dei dati di callback di memoria o per il trasferimento di dati di file.

Sintassi

typedef struct _MINIDRV_TRANSFER_CONTEXT {
  LONG                lSize;
  LONG                lWidthInPixels;
  LONG                lLines;
  LONG                lDepth;
  LONG                lXRes;
  LONG                lYRes;
  LONG                lCompression;
  GUID                guidFormatID;
  LONG                tymed;
  LONG_PTR            hFile;
  LONG                cbOffset;
  LONG                lBufferSize;
  LONG                lActiveBuffer;
  LONG                lNumBuffers;
  BYTE                *pBaseBuffer;
  BYTE                *pTransferBuffer;
  BOOL                bTransferDataCB;
  BOOL                bClassDrvAllocBuf;
  LONG_PTR            lClientAddress;
  IWiaMiniDrvCallBack *pIWiaMiniDrvCallBack;
  LONG                lImageSize;
  LONG                lHeaderSize;
  LONG                lItemSize;
  LONG                cbWidthInBytes;
  LONG                lPage;
  LONG                lCurIfdOffset;
  LONG                lPrevIfdOffset;
} MINIDRV_TRANSFER_CONTEXT, *PMINIDRV_TRANSFER_CONTEXT;

Members

lSize

Specifica le dimensioni in byte di questa struttura MINIDRV_TRANSFER_CONTEXT.

lWidthInPixels

Specifica la larghezza in pixel dell'immagine corrente. Il valore di questo membro è derivato dalla proprietà WIA_IPA_PIXELS_PER_LINE elemento comune.

lLines

Specifica il numero totale di righe (il numero di righe orizzontali di pixel) nell'immagine corrente. Il valore di questo membro è derivato dalla proprietà WIA_IPA_NUMBER_OF_LINES elemento comune.

lDepth

Specifica il valore di profondità del colore dell'immagine corrente in bit per pixel. Il valore di questo membro è derivato dalla proprietà WIA_IPA_DEPTH elemento comune.

lXRes

Specifica la risoluzione orizzontale corrente dell'immagine in pixel per pollice. Il valore di questo membro è derivato dalla proprietà dell'elemento dello scanner WIA_IPS_XRES.

lYRes

Specifica la risoluzione verticale corrente dell'immagine in pixel per pollice. Il valore di questo membro è derivato dalla proprietà dell'elemento dello scanner WIA_IPS_YRES.

lCompression

Specifica il tipo di compressione utilizzato dal dispositivo. Il valore di questo membro è derivato dalla proprietà WIA_IPA_COMPRESSION elemento comune.

guidFormatID

Specifica un GUID che indica il formato dei dati per il dispositivo. Il valore di questo membro è derivato dalla proprietà WIA_IPA_FORMAT elemento comune.

tymed

Specifica il tipo di trasferimento dei dati. Il trasferimento dei dati specificato può essere un trasferimento di callback di memoria (TYMED_CALLBACK o TYMED_MULTIPAGE_CALLBACK) o un trasferimento di file (TYMED_FILE o TYMED_MULTIPAGE_FILE). Il valore di questo membro è derivato dalla proprietà WIA_IPA_TYMED elemento comune.

Questo membro fornisce informazioni correlate a tale elemento nel membro bTransferDataCB . Vedere osservazioni Per ulteriori informazioni.

hFile

Specifica l'handle per il file aperto utilizzato durante i trasferimenti di file. Il minidriver non deve usare questo membro. Vedere osservazioni Per ulteriori informazioni.

cbOffset

Specifica l'offset corrente in byte della posizione del buffer successiva utilizzata durante questo trasferimento.

lBufferSize

Specifica le dimensioni totali del buffer di trasferimento.

lActiveBuffer

Specifica il buffer utilizzato per il trasferimento corrente. Il valore di questo membro deve essere compreso nell'intervallo compreso tra 1 e lNumBuffers.

lNumBuffers

Specifica il numero di buffer disponibili per il trasferimento dei dati. Questo valore può essere attualmente 1 o 2.

pBaseBuffer

Punta all'inizio del buffer di trasferimento di base.

pTransferBuffer

Punta all'inizio del buffer di trasferimento corrente. Per un trasferimento di callback in cui viene usato il doppio buffering, questo membro alterna tra i due buffer, puntando all'inizio del primo buffer e quindi all'inizio del secondo e così via.

bTransferDataCB

Specifica se un trasferimento di dati è un trasferimento di callback di memoria o un trasferimento di file. Questo membro è impostato su TRUE se il trasferimento è un trasferimento di callback di memoria e FALSE se il trasferimento è un trasferimento di file. Per i trasferimenti di file, il servizio WIA in genere fornisce una routine di callback, che consente all'applicazione di ricevere gli aggiornamenti dal minidriver sullo stato del trasferimento del file. Il servizio WIA fornisce una routine di callback se l'applicazione fornisce una routine di callback personalizzata. Per informazioni dettagliate, vedere Interfaccia COM IWiaMiniDrvCallback . Per i trasferimenti di file, un minidriver deve controllare il valore archiviato nel membro pIWiaMiniDrvCallBack . Se il membro è NULL, il servizio WIA non fornisce una routine di callback, pertanto il driver non deve tentare di chiamarlo. Per i trasferimenti di callback di memoria, il servizio WIA fornisce sempre un callback.

Questo membro fornisce informazioni correlate a tale elemento nel membro tymed . Vedere osservazioni Per ulteriori informazioni.

bClassDrvAllocBuf

Specifica se il servizio WIA ha allocato il buffer di trasferimento. Questo valore è TRUE se il servizio WIA ha allocato il buffer e FALSE in caso contrario. In tal caso, è responsabilità del minidriver allocare il buffer di trasferimento.

lClientAddress

Specifica l'indirizzo, nello spazio indirizzi del client, del trasferimento. Il minidriver non deve modificare questo valore.

pIWiaMiniDrvCallBack

Punta a un'interfaccia IWiaMiniDrvCallBack usata per il trasferimento di callback di dati o di stato.

lImageSize

Specifica le dimensioni, in byte, dei bit non compressi in una singola pagina.

lHeaderSize

Specifica le dimensioni, in byte, dei dati di intestazione dell'immagine in una singola pagina.

lItemSize

Specifica le dimensioni, in byte, di bit e intestazione. Questo valore può essere zero se la dimensione dell'articolo è sconosciuta prima dell'acquisizione.

cbWidthInBytes

Specifica le dimensioni, in byte, di una linea di immagine.

lPage

Specifica il numero di pagina della pagina corrente durante l'analisi di un'immagine TIFF a più pagine. La numerazione delle pagine inizia con zero.

lCurIfdOffset

Specifica l'offset della directory dei file di immagine (IFD) nella pagina corrente di un'immagine TIFF a più pagine.

lPrevIfdOffset

Specifica l'offset della directory dei file di immagine (IFD) nella pagina precedente di un'immagine TIFF a più pagine.

Commenti

Il servizio WIA imposta la maggior parte dei membri di questa struttura prima di chiamare il metodo IWiaMiniDrv::d rvAcquireItemData del minidriver. Se il minidriver chiama wiasGetImageInformation, tale funzione riempie i membri rimanenti del MINIDRV_TRANSFER_CONTEXT passati.

Poiché il servizio WIA attualmente usa solo le costanti TYMED_FILE e TYMED_CALLBACK, i membri tymed e bTransferDataCB archiviano essenzialmente le stesse informazioni. Per i trasferimenti di file, quando bTransferDataCB è impostato su FALSE, tymed è impostato su TYMED_FILE o TYMED_MULTIPAGE_FILE. Per i trasferimenti di callback di memoria, quando bTransferDataCB è impostato su TRUE, tymed è impostato su TYMED_CALLBACK o TYMED_MULTIPAGE_CALLBACK.

Il membro hFile è riservato esclusivamente al servizio WiA. Anziché usare questo membro per i trasferimenti di file, il minidriver deve invece scrivere i dati in un buffer e quindi chiamare wiasWritePageBufToFile per completare il trasferimento del file.

Il minidriver ottiene i valori da specifiche proprietà comuni o degli elementi dello scanner per impostare i membri illustrati nella tabella seguente:

In genere, il minidriver imposta i membri della struttura precedenti direttamente dai valori delle proprietà dell'elemento. Un'applicazione o il minidriver avranno impostato le proprietà dell'elemento in precedenza. Il servizio WIA compila il contesto del servizio, usando i valori delle proprietà. Il driver può usare i valori archiviati in questo contesto per riferimento rapido.

Il servizio WIA imposta i membri della struttura seguenti:

• hFile

• bTransferDataCB

• bClassDrvAllocBuf

La funzione della libreria del servizio wiasGetImageInformation imposta i membri della struttura seguenti:

• lImageSize

• lHeaderSize

• lItemSize

• cbWidthInBytes

I membri seguenti di questa struttura vengono usati nei callback di trasferimento dei dati. Il servizio WIA o il minidriver imposta questi membri. In diversi casi, il valore archiviato in bClassDrvAllocBuf determina se il servizio WIA o il minidriver imposta il membro.

Requisiti

Vedi anche

IWiaMiniDrv::d rvAcquireItemData

IWiaMiniDrvCallBack::MiniDrvCallback

wiasGetImageInformation

wiasWritePageBufToFile