WIA_RAW_HEADER Struktur

Die WIA_RAW_HEADER-Struktur definiert ein Bild im RAW-Datenformat eines Geräts und ermöglicht Es Anwendungen, das RAW-Format bei WIA-Übertragungen (Windows Image Acquisition) zu verwenden.

Syntax

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;

Member

Tag

Art: DWORD

Der Name des Formats. Dabei muss es sich um das Literal "WRAW" (vier ASCII-Zeichen mit einzelen Byte) handeln.

Version

Art: DWORD

Die Version des RAW-Formats. Verwenden Sie immer 0x00010000.

HeaderSize

Art: DWORD

Die insgesamt gültigen Bytes im Header.

XRes

Art: DWORD

Die horizontale Auflösung als DPI-Wert.

YRes

Art: DWORD

Die vertikale Auflösung als DPI-Wert.

XExtent

Art: DWORD

Die Breite des Bilds in Pixeln.

YExtent

Art: DWORD

Die Höhe des Bilds in Pixeln.

BytesPerLine

Art: DWORD

Die Anzahl der Bytes in einer Zeile eines nicht komprimierten Bilds. Verwenden Sie 0, wenn die Daten komprimiert werden, um zu signalisieren, dass die Anzahl der Bytes pro Zeile unbekannt ist.

BitsPerPixel

Art: DWORD

Die Gesamtanzahl der Bits pro Pixel für alle Kanäle des Pixels.

ChannelsPerPixel

Art: DWORD

Die Anzahl der Farbkanäle in einem Pixel.

DataType

Art: DWORD

Die WIA_IPA_DATATYPE des Bilds. Da WIA_IPA_FORMAT auf WiaImgFmt_RAW festgelegt ist, ist dies eine Liste zulässiger Werte, aus denen die Anwendung auswählt.

BitsPerChannel[8]

Typ: BYTE

Die Anzahl der Bits in einem Kanal, bis maximal 8.

Komprimierung

Art: DWORD

Ein WIA_IPA_COMPRESSION Wert, der den Typ der verwendeten Komprimierung angibt, falls vorhanden.

PhotometricInterp

Art: DWORD

Ein WIA_IPA_PHOTOMETRIC_INTERP Wert, der die photometrische Interpretation des Bilds angibt.

LineOrder

Art: DWORD

Ein Wert, der die Reihenfolge der Bildzeile darstellt. Dies ist immer entweder WIA_LINE_ORDER_TOP_TO_BOTTOM oder WIA_LINE_ORDER_BOTTOM_TO_TOP.

RawDataOffset

Art: DWORD

Die Position der Rohbilddaten in Bytes, beginnend mit der Position, an der der Header endet, oder der Position, an der die Palette endet.

RawDataSize

Art: DWORD

Die Größe der Rohbilddaten in Bytes.

PaletteOffset

Art: DWORD

Die Position der Palette in Bytes, beginnend von der Position, an der der Header endet, oder der Position, an der die Daten enden. (Dieser Wert ist 0, wenn keine Palette vorhanden ist.)

PaletteSize

Art: DWORD

Die Größe der Palettentabelle in Bytes. (Dies ist 0, wenn keine Palette vorhanden ist.)

Bemerkungen

Da dies kein Dateiformat ist, verwenden Sie eine leere Zeichenfolge für die WIA_IPA_FILE_EXTENSION-Eigenschaft.

Die Palette und die Daten können in beiden Reihenfolgen erfolgen.

RawDataSize enthält weder den Header noch die Palette. Verwenden Sie dieses Feld, um zu überprüfen, ob die Übertragung des Bilds erfolgreich war.

PaletteSize ist Bytes, nicht die Anzahl der Einträge in der Palette.

Anforderungen