MINIDRV_TRANSFER_CONTEXT-Struktur (wiamindr_lh.h)
Die MINIDRV_TRANSFER_CONTEXT-Struktur wird verwendet, um Bild- und andere Informationen zu speichern, die für eine Speicherrückrufdatenübertragung oder eine Dateidatenübertragung erforderlich sind.
Syntax
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;
Member
lSize
Gibt die Größe dieser MINIDRV_TRANSFER_CONTEXT-Struktur in Bytes an.
lWidthInPixels
Gibt die Breite des aktuellen Bilds in Pixel an. Der Wert dieses Elements wird von der WIA_IPA_PIXELS_PER_LINE allgemeinen Elementeigenschaft abgeleitet.
lLines
Gibt die Gesamtanzahl von Zeilen (die Anzahl der horizontalen Zeilen von Pixeln) im aktuellen Bild an. Der Wert dieses Elements wird von der WIA_IPA_NUMBER_OF_LINES common item-Eigenschaft abgeleitet.
lDepth
Gibt den Farbtiefewert des aktuellen Bilds in Bits pro Pixel an. Der Wert dieses Elements wird von der WIA_IPA_DEPTH allgemeinen Elementeigenschaft abgeleitet.
lXRes
Gibt die aktuelle horizontale Auflösung des Bilds in Pixel pro Zoll an. Der Wert dieses Members wird von der WIA_IPS_XRES Scannerelementeigenschaft abgeleitet.
lYRes
Gibt die aktuelle vertikale Auflösung des Bilds in Pixel pro Zoll an. Der Wert dieses Members wird von der Eigenschaft WIA_IPS_YRES Scannerelements abgeleitet.
lCompression
Gibt den Vom Gerät verwendeten Komprimierungstyp an. Der Wert dieses Members wird von der WIA_IPA_COMPRESSION allgemeinen Elementeigenschaft abgeleitet.
guidFormatID
Gibt eine GUID an, die das Datenformat für das Gerät angibt. Der Wert dieses Members wird von der WIA_IPA_FORMAT common item-Eigenschaft abgeleitet.
tymed
Gibt den Typ der Datenübertragung an. Die angegebene Datenübertragung kann entweder eine Speicherrückrufübertragung (TYMED_CALLBACK oder TYMED_MULTIPAGE_CALLBACK) oder eine Dateiübertragung (TYMED_FILE oder TYMED_MULTIPAGE_FILE) sein. Der Wert dieses Members wird von der WIA_IPA_TYMED common item-Eigenschaft abgeleitet.
Dieses Element übermittelt Informationen zu diesem Element im bTransferDataCB-Member . Weitere Informationen finden Sie unter Hinweise .
hFile
Gibt das Handle für die geöffnete Datei an, die bei Dateiübertragungen verwendet wird. Der Minidriver sollte diesen Member nicht verwenden. Weitere Informationen finden Sie unter Hinweise .
cbOffset
Gibt den aktuellen Offset in Bytes des nächsten Pufferspeicherorts an, der während dieser Übertragung verwendet wird.
lBufferSize
Gibt die Gesamtgröße des Übertragungspuffers an.
lActiveBuffer
Gibt an, welcher Puffer für die aktuelle Übertragung verwendet wird. Der Wert dieses Members muss im Bereich von 1 bis lNumBuffers liegen.
lNumBuffers
Gibt die Anzahl der für die Datenübertragung verfügbaren Puffer an. Dieser Wert kann derzeit entweder 1 oder 2 sein.
pBaseBuffer
Zeigt auf den Anfang des Basisübertragungspuffers.
pTransferBuffer
Zeigt auf den Anfang des aktuellen Übertragungspuffers. Bei einer Rückrufübertragung, bei der doppelter Puffer verwendet wird, wechselt dieser Member zwischen den beiden Puffern, wobei auf den Anfang des ersten Puffers und dann auf den Anfang des zweiten Puffers verweist usw.
bTransferDataCB
Gibt an, ob eine Datenübertragung eine Speicherrückrufübertragung oder eine Dateiübertragung ist. Dieser Member ist auf TRUE festgelegt, wenn es sich bei der Übertragung um eine Speicherrückrufübertragung handelt, und auf FALSE , wenn es sich bei der Übertragung um eine Dateiübertragung handelt. Für Dateiübertragungen bietet der WIA-Dienst in der Regel eine Rückrufroutine, die es der Anwendung ermöglicht, Updates vom Minidriver zum status der Dateiübertragung zu empfangen. (Der WIA-Dienst bietet eine Rückrufroutine, wenn die Anwendung eine eigene Rückrufroutine bereitstellt. Weitere Informationen finden Sie unter IWiaMiniDrvCallback COM-Schnittstelle .) Bei Dateiübertragungen sollte ein Minidriver den wert überprüfen, der im pIWiaMiniDrvCallBack-Element gespeichert ist. Wenn dieser Member NULL ist, stellt der WIA-Dienst keine Rückrufroutine bereit, sodass der Treiber nicht versuchen darf, ihn aufzurufen. Für Speicherrückrufübertragungen stellt der WIA-Dienst immer einen Rückruf bereit.
Dieses Element übermittelt Informationen zu diesem Element im tymed-Element . Weitere Informationen finden Sie unter Hinweise .
bClassDrvAllocBuf
Gibt an, ob der WIA-Dienst den Übertragungspuffer zugewiesen hat. Dieser Wert ist TRUE , wenn der WIA-Dienst den Puffer zugewiesen hat, und FALSE , falls nicht. In diesem Fall liegt es in der Verantwortung des Minitreibers, den Übertragungspuffer zuzuweisen.
lClientAddress
Gibt die Adresse der Übertragung im Adressraum des Clients an. Der Minidriver darf diesen Wert nicht ändern.
pIWiaMiniDrvCallBack
Verweist auf eine IWiaMiniDrvCallBack-Schnittstelle, die für daten- oder status Rückrufübertragung verwendet wird.
lImageSize
Gibt die Größe von nicht komprimierten Bits auf einer einzelnen Seite in Bytes an.
lHeaderSize
Gibt die Größe von Bildheaderdaten auf einer einzelnen Seite in Bytes an.
lItemSize
Gibt die Größe von Bits und Headern in Bytes an. Dieser Wert kann 0 sein, wenn die Elementgröße vor dem Erwerb unbekannt ist.
cbWidthInBytes
Gibt die Größe einer Bildzeile in Bytes an.
lPage
Gibt die Seitenzahl der aktuellen Seite an, wenn ein mehrseitiges TIFF-Bild überprüft wird. Die Seitennummerierung beginnt mit 0.
lCurIfdOffset
Gibt den IFD-Offset (Image File Directory) auf der aktuellen Seite eines mehrseitigen TIFF-Images an.
lPrevIfdOffset
Gibt den IfD-Offset (Image File Directory) auf der vorherigen Seite eines mehrseitigen TIFF-Images an.
Hinweise
Der WIA-Dienst legt die meisten Member dieser Struktur fest, bevor er die IWiaMiniDrv::d rvAcquireItemData-Methode des Minidrivers aufruft. Wenn der Minidriver wiasGetImageInformation aufruft, füllt diese Funktion die restlichen Member der MINIDRV_TRANSFER_CONTEXT an sie übergeben werden aus.
Da der WIA-Dienst derzeit nur die TYMED_FILE und TYMED_CALLBACK Konstanten verwendet, speichern die Tymed - und bTransferDataCB-Member im Wesentlichen dieselben Informationen. Wenn bTransferDataCB bei Dateiübertragungen auf FALSE festgelegt ist, wird tymed entweder auf TYMED_FILE oder TYMED_MULTIPAGE_FILE festgelegt. Wenn bTransferDataCB bei Speicherrückrufübertragungen auf TRUE festgelegt ist, wird tymed entweder auf TYMED_CALLBACK oder TYMED_MULTIPAGE_CALLBACK festgelegt.
Das hFile-Element ist ausschließlich für die Verwendung durch den WIA-Dienst reserviert. Anstatt diesen Member für Dateiübertragungen zu verwenden, sollte der Minidriver stattdessen die Daten in einen Puffer schreiben und dann wiasWritePageBufToFile aufrufen, um die Dateiübertragung abzuschließen.
Der Minidriver ruft Werte aus bestimmten allgemeinen Eigenschaften oder Scannerelementeigenschaften ab, um die in der folgenden Tabelle dargestellten Elemente festzulegen:
| Mitglied | Festlegen durch |
|---|---|
| lWidthInPixels | WIA_IPA_PIXELS_PER_LINE |
| lLines | WIA_IPA_NUMBER_OF_LINES |
| lDepth | WIA_IPA_DEPTH |
| lXRes | WIA_IPS_XRES |
| lYRes | WIA_IPS_YRES |
| lKompression | WIA_IPA_COMPRESSION |
| guidFormatID | WIA_IPA_FORMAT |
| Tymed | WIA_IPA_TYMED |
In der Regel legt der Minidriver die vorherigen Strukturelemente direkt aus den Werten der Elementeigenschaften fest. Eine Anwendung oder der Minidriver hat die Elementeigenschaften zuvor festgelegt. Der WIA-Dienst füllt seinen Dienstkontext unter Verwendung der Eigenschaftswerte aus. Der Treiber kann die in diesem Kontext gespeicherten Werte als Kurzübersicht verwenden.
Der WIA-Dienst legt die folgenden Strukturmber fest:
hFile
bTransferDataCB
bClassDrvAllocBuf
Entweder der minidriver oder die wiasGetImageInformation-Dienstbibliotheksfunktion legt die folgenden Strukturmber fest:
lImageSize
lHeaderSize
lItemSize
cbWidthInBytes
Die folgenden Elemente dieser Struktur werden in Datenübertragungsrückrufen verwendet. Der WIA-Dienst oder der Minidriver legt diese Member fest. In mehreren Fällen bestimmt der in bClassDrvAllocBuf gespeicherte Wert, ob der WIA-Dienst oder der Minidriver das Element festlegt.
| Mitglied | Festlegen durch |
|---|---|
| cbOffset | Minidriver |
| lBufferSize | WIA-Dienst oder Minidriver. Wenn bClassDrvAllocBuftrue ist, legt der WIA-Dienst diesen Member fest. andernfalls legt der Minidriver es fest. |
| lActiveBuffer | WIA-Dienst. Dieser Member darf vom Minidriver nicht geändert werden. |
| lNumBuffers | WIA-Dienst. Dieser Member darf vom Minidriver nicht geändert werden. |
| pBaseBuffer | WIA-Dienst oder Minidriver. Wenn bClassDrvAllocBuftrue ist, legt der WIA-Dienst diesen Member fest. andernfalls legt der Minidriver es fest. |
| pTransferBuffer | WIA-Dienst oder Minidriver. Wenn bClassDrvAllocBuftrue ist, legt der WIA-Dienst diesen Member fest. andernfalls legt der Minidriver es fest. |
| lClientAddress | WIA-Dienst. Dieser Member darf vom Minidriver nicht geändert werden. |
| pIWiaMiniDrvCallBack | WIA-Dienst |
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | wiamindr_lh.h (einschließlich Wiamindr.h) |
Weitere Informationen
IWiaMiniDrv::d rvAcquireItemData