UNIDRV_PRIVATE_DEVMODE Struktur (printoem.h)

Artikel
02/26/2024

Mit der UNIDRV_PRIVATE_DEVMODE-Struktur können Unidrv-Plug-Ins die Größe des privaten Teils der DEVMODEW-Struktur von Unidrv bestimmen.

Syntax

typedef struct _UNIDRV_PRIVATE_DEVMODE {
  WORD wReserved[4];
  WORD wSize;
} UNIDRV_PRIVATE_DEVMODE, *PUNIDRV_PRIVATE_DEVMODE;

Member

wReserved[4]

Ist für das System reserviert.

wSize

Die Größe des privaten Teils der DEVMODEW-Struktur von Unidrv in Bytes.

Hinweise

Informationen zu den öffentlichen und privaten Abschnitten der DEVMODEW-Struktur finden Sie unter DEVMODEW.

Printoem.h definiert ein Makro zum Bestimmen der Größe des privaten Teils der DEVMODEW-Struktur von Unidrv.

#define GET_UNIDRV_PRIVATE_DEVMODE_SIZE(pdm)\
    ( ( (pdm)->dmDriverExtra > (FIELD_OFFSET(UNIDRV_PRIVATE_DEVMODE, wSize) + sizeof(WORD)) ) ? \
    ((PUNIDRV_PRIVATE_DEVMODE)((PBYTE)(pdm) + (pdm)-> dmSize)) -> wSize : 0 )

Das pdm-Argument im GET_UNIDRV_PRIVATE_DEVMODE_SIZE Makro ist ein Zeiger auf eine DEVMODEW-Struktur . Das Makro bestimmt, ob der Wert des dmDriverExtra-Members der DEVMODEW-Struktur größer als der Byteoffset des wSize-Elements der UNIDRV_PRIVATE_DEVMODE-Struktur ist. Wenn ja, gibt das Makro den Wert des wSize-Elements in der UNIDRV_PRIVATE_DEVMODE-Struktur zurück. Andernfalls gibt das Makro null zurück.

Gehen Sie wie folgt vor, um die Adresse des privaten Teils der DEVMODEW-Struktur Ihres Plug-Ins sicher zu bestimmen:

Rufen Sie das makro GET_UNIDRV_PRIVATE_DEVMODE_SIZE auf, und übergeben Sie die Adresse der DEVMODEW-Struktur im Aufruf.
Stellen Sie sicher, dass (pdm)->dmDriverExtra größer als der vom Makro zurückgegebene Wert ist. (Das Makro gibt den Wert des wSize-Members der UNIDRV_PRIVATE_DEVMODE-Struktur zurück.)
Bestimmen Sie die Adresse des privaten Teils der DEVMODEW-Struktur Ihres Plug-Ins wie folgt.
```
pdmPlugin = (PBYTE)(pdm) + (pdm)->dmSize + wSize;
```
Das vorherige Beispiel beginnt mit der Adresse der öffentlichen DEVMODEW-Struktur (pdm), fügt die Anzahl der Bytes dieser Struktur (pdm-dmSize) hinzu und fügt dann die Größe in Bytes der privaten DEVMODEW-Struktur> (wSize) von Unidrv hinzu. Die privaten DEVMODEW-Daten eines Plug-Ins beginnen an dieser Speicheradresse. Wenn mehrere Plug-Ins miteinander verkettet sind, ist die von diesem Beispiel zurückgegebene Adresse die der privaten DEVMODEW-Daten des ersten Plug-Ins. Die privaten DEVMODEW-Daten des zweiten Plug-Ins folgen den privaten DEVMODEW-Daten des ersten Plug-Ins, die privaten DEVMODEW-Daten des dritten Plug-Ins folgen den privaten DEVMODEW-Daten des zweiten Plug-Ins usw. Ein Plug-In-Entwickler, der die Adresse der privaten DEVMODEW-Daten des n-th-Plug-Ins ermitteln muss, muss die Größe der privaten DEVMODEW-Daten für die ersten n - 1-Plug-Ins kennen.
Stellen Sie sicher, dass der private Teil der DEVMODEW-Struktur Ihres Plug-Ins mit einer gültigen OEM_DMEXTRAHEADER-Struktur beginnt.

Anforderungen

Anforderung	Wert
Header	printoem.h (include Printoem.h)

Weitere Informationen

PSCRIPT5_PRIVATE_DEVMODE