struttura WIA_RAW_HEADER

La struttura WIA_RAW_HEADER definisce un'immagine nel formato dati RAW di un dispositivo e consente alle applicazioni di usare il formato RAW nei trasferimenti wia (Windows Image Acquisition).

Sintassi

typedef struct _WIA_RAW_HEADER {
  DWORD Tag;
  DWORD Version;
  DWORD HeaderSize;
  DWORD XRes;
  DWORD YRes;
  DWORD XExtent;
  DWORD YExtent;
  DWORD BytesPerLine;
  DWORD BitsPerPixel;
  DWORD ChannelsPerPixel;
  DWORD DataType;
  BYTE  BitsPerChannel[8];
  DWORD Compression;
  DWORD PhotometricInterp;
  DWORD LineOrder;
  DWORD RawDataOffset;
  DWORD RawDataSize;
  DWORD PaletteOffset;
  DWORD PaletteSize;
} WIA_RAW_HEADER;

Members

Tag

Tipo: DWORD

Nome del formato. Deve essere il valore letterale "WRAW" (quattro caratteri ASCII a byte singolo).

Versione

Tipo: DWORD

Versione del formato RAW. Usare sempre 0x00010000.

HeaderSize

Tipo: DWORD

Byte validi totali nell'intestazione.

XRes

Tipo: DWORD

Risoluzione orizzontale espressa in punti per pollice.

YRes

Tipo: DWORD

Risoluzione verticale espressa in punti per pollice.

XExtent

Tipo: DWORD

Larghezza dell'immagine in pixel.

YExtent

Tipo: DWORD

Altezza dell'immagine in pixel.

BytePerLine

Tipo: DWORD

Numero di byte in una riga di un'immagine non compressa. Usare 0 quando i dati vengono compressi per segnalare che il numero di byte per riga è sconosciuto.

BitsPerPixel

Tipo: DWORD

Numero totale di bit per pixel per tutti i canali del pixel.

ChannelsPerPixel

Tipo: DWORD

Numero di canali di colore in un pixel.

DataType

Tipo: DWORD

WIA_IPA_DATATYPE dell'immagine. Poiché WIA_IPA_FORMAT è impostato su WiaImgFmt_RAW, si tratta di un elenco di valori consentiti da cui l'applicazione seleziona.

BitsPerChannel[8]

Tipo: BYTE

Numero di bit in un canale, fino a un massimo di 8.

Compressione

Tipo: DWORD

Valore WIA_IPA_COMPRESSION che specifica il tipo di compressione utilizzato, se presente.

PhotometricInterp

Tipo: DWORD

Valore WIA_IPA_PHOTOMETRIC_INTERP che specifica l'interpretazione fotometrica dell'immagine.

LineOrder

Tipo: DWORD

Valore che rappresenta l'ordine della riga dell'immagine. Questo è sempre WIA_LINE_ORDER_TOP_TO_BOTTOM o WIA_LINE_ORDER_BOTTOM_TO_TOP.

RawDataOffset

Tipo: DWORD

Posizione dei dati dell'immagine non elaborata in byte, a partire dalla posizione in cui termina l'intestazione o dalla posizione in cui termina la tavolozza.

RawDataSize

Tipo: DWORD

Dimensione, in byte, dei dati di immagine non elaborati.

PaletteOffset

Tipo: DWORD

Posizione della tavolozza in byte, a partire dalla posizione in cui termina l'intestazione o dalla posizione in cui terminano i dati. Questo valore è 0, se non è presente alcuna tavolozza.

PaletteSize

Tipo: DWORD

Dimensione, in byte, della tabella della tavolozza. (Questo è 0, se non c'è tavolozza.

Commenti

Poiché non si tratta di un formato di file, utilizzare una stringa vuota per la proprietà WIA_IPA_FILE_EXTENSION.

La tavolozza e i dati possono venire in entrambi gli ordini.

RawDataSize non include l'intestazione o la tavolozza. Usare questo campo per verificare che il trasferimento dell'immagine abbia avuto esito positivo.

PaletteSize è byte, non il numero di voci nella tavolozza.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Wiadef.h