MONITOR2-Struktur (winsplp.h)

Die MONITOR2-Struktur enthält Zeiger auf die von Druckmonitoren definierten Funktionen.

Syntax

typedef struct _MONITOR2 {
  DWORD  cbSize;
  BOOL( )(HANDLE hMonitor,LPWSTR pName,DWORD Level,LPBYTE pPorts,DWORD cbBuf,LPDWORD pcbNeeded,LPDWORD pcReturned)  *pfnEnumPorts;
  BOOL( )(HANDLE hMonitor,LPWSTR pName,PHANDLE pHandle)  *pfnOpenPort;
  BOOL()(HANDLE hMonitor,HANDLE hMonitorPort,LPWSTR pPortName,LPWSTR pPrinterName,PHANDLE pHandle,_MONITOR2 *pMonitor2)  * pfnOpenPortEx;
  BOOL( )(HANDLE hPort,LPWSTR pPrinterName,DWORD JobId,DWORD Level,LPBYTE pDocInfo)  *pfnStartDocPort;
  BOOL( )(HANDLE hPort,LPBYTE pBuffer,DWORD cbBuf,LPDWORD pcbWritten)  *pfnWritePort;
  BOOL( )(HANDLE hPort,LPBYTE pBuffer,DWORD cbBuffer,LPDWORD pcbRead)  *pfnReadPort;
  BOOL( )(HANDLE hPort)  *pfnEndDocPort;
  BOOL( )(HANDLE hPort)  *pfnClosePort;
  BOOL( )(HANDLE hMonitor,LPWSTR pName,HWND hWnd,LPWSTR pMonitorName)  *pfnAddPort;
  BOOL( )(HANDLE hMonitor,LPWSTR pName,DWORD Level,LPBYTE lpBuffer,LPWSTR lpMonitorName)  *pfnAddPortEx;
  BOOL( )(HANDLE hMonitor,LPWSTR pName,HWND hWnd,LPWSTR pPortName)  *pfnConfigurePort;
  BOOL( )(HANDLE hMonitor,LPWSTR pName,HWND hWnd,LPWSTR pPortName)  *pfnDeletePort;
  BOOL( )(HANDLE hPort,DWORD ControlID,LPWSTR pValueName,LPWSTR lpInBuffer,DWORD cbInBuffer,LPWSTR lpOutBuffer,DWORD cbOutBuffer,LPDWORD lpcbReturned)  *pfnGetPrinterDataFromPort;
  BOOL( )(HANDLE hPort,LPCOMMTIMEOUTS lpCTO,DWORD reserved)  *pfnSetPortTimeOuts;
  BOOL( )(HANDLE hMonitor,LPCWSTR pszObject,ACCESS_MASK GrantedAccess,PHANDLE phXcv)  *pfnXcvOpenPort;
  DWORD( )(HANDLE hXcv,LPCWSTR pszDataName,PBYTE pInputData,DWORD cbInputData,PBYTE pOutputData,DWORD cbOutputData,PDWORD pcbOutputNeeded) *pfnXcvDataPort;
  BOOL( )(HANDLE hXcv)  *pfnXcvClosePort;
  VOID( )(HANDLE hMonitor)  *pfnShutdown;
  DWORD()(HANDLE hPort,DWORD dwAccessBit,LPCWSTR pAction,PBIDI_REQUEST_CONTAINER pReqData,PBIDI_RESPONSE_CONTAINER *ppResData) * pfnSendRecvBidiDataFromPort;
  DWORD()(HANDLE hMonitor,DWORD cPorts,PCWSTR *ppszPorts) * pfnNotifyUsedPorts;
  DWORD()(HANDLE hMonitor,DWORD cPorts,PCWSTR *ppszPorts) * pfnNotifyUnusedPorts;
  DWORD()(HANDLE hMonitor,DWORD event,POWERBROADCAST_SETTING *pSettings) * pfnPowerEvent;
} MONITOR2, *PMONITOR2, *LPMONITOR2;

Member

cbSize

Gibt die Größe der MONITOR2-Struktur in Bytes an.

pfnEnumPorts

Die EnumPorts-Funktion einer Portmonitorserver-DLL listet die Vom Portmonitor unterstützten Ports auf.

pfnOpenPort

Zeiger auf die OpenPort-Funktion des Druckmonitors.

pfnOpenPortEx

Die OpenPortEx-Funktion eines Sprachmonitors öffnet einen Druckeranschluss.

pfnStartDocPort

Die StartDocPort-Funktion eines Druckmonitors führt die Aufgaben aus, die zum Starten eines Druckauftrags am angegebenen Port erforderlich sind.

pfnWritePort

Zeiger auf die WritePort-Funktion des Druckmonitors.

pfnReadPort

Zeiger auf die ReadPort-Funktion des Druckmonitors.

pfnEndDocPort

Die EndDocPort-Funktion eines Druckmonitors führt die Aufgaben aus, die zum Beenden eines Druckauftrags am angegebenen Port erforderlich sind.

pfnClosePort

Zeiger auf die ClosePort-Funktion des Druckmonitors.

pfnAddPort

AddPort erstellt einen Port und fügt ihn der Liste der Ports hinzu, die derzeit vom angegebenen Monitor in der Spooler-Umgebung unterstützt werden.

pfnAddPortEx

(Veraltet. Muss NULL sein.) Zeiger auf die AddPortEx-Funktion des Druckmonitors. (Nur Portmonitore.)

pfnConfigurePort

ConfigurePort ist eine Portverwaltungsfunktion, die den angegebenen Port konfiguriert.

pfnDeletePort

DeletePort löscht einen Port aus der Umgebung des Monitors.

pfnGetPrinterDataFromPort

Zeiger auf die GetPrinterDataFromPort-Funktion des Druckmonitors.

pfnSetPortTimeOuts

Die SetPortTimeOuts-Funktion einer Portmonitorserver-DLL legt Porttimeoutwerte für einen offenen Port fest.

pfnXcvOpenPort

Zeiger auf die XcvOpenPort-Funktion des Druckmonitors. (Nur Portmonitore.)

pfnXcvDataPort

Zeiger auf die XcvDataPort-Funktion des Druckmonitors. (Nur Portmonitore.)

pfnXcvClosePort

Zeiger auf die XcvClosePort-Funktion des Druckmonitors. (Nur Portmonitore.)

pfnShutdown

Zeiger auf die Shutdown-Funktion des Druckmonitors.

pfnSendRecvBidiDataFromPort

Zeiger auf die SendRecvBidiDataFromPort-Funktion des Druckmonitors.

pfnNotifyUsedPorts

Zeiger auf die NotifyUsedPorts-Funktion des Druckmonitors .

pfnNotifyUnusedPorts

Zeiger auf die NotifyUnusedPorts-Funktion des Druckmonitors .

pfnPowerEvent

Zeiger auf die PowerEvent-Funktion des Druckmonitors.

Hinweise

Jeder Sprachmonitor und jede Portmonitorserver-DLL muss eine MONITOR2 Struktur bereitstellen. Der Monitor muss Werte für alle Strukturmember bereitstellen und die Adresse der Struktur als Rückgabewert für die InitializePrintMonitor2-Funktion angeben.

Wenn eine Funktion nicht definiert ist, muss ihr Zeiger NULL sein.

Die MONITOR2 Struktur ist in Windows XP größer als in Windows 2000. Um sicherzustellen, dass ein mit dem Windows XP Driver Development Kit (DDK) entwickelter Monitor unter Windows XP und Windows 2000 installiert wird, muss der Monitor Folgendes tun:

• Führen Sie eine Laufzeitüberprüfung durch, um zu ermitteln, unter welcher Betriebssystemversion der Monitor ausgeführt wird.
• Wenn der Monitor unter Windows 2000 ausgeführt wird, muss er den cbSize-Member der MONITOR2-Struktur auf MONITOR2_SIZE_WIN2K festlegen (definiert in Winsplp.h), die Größe, die für die Windows 2000-Version dieser Struktur geeignet ist.

Die folgende Funktion bestimmt, ob die aktuelle Betriebssystemversion Windows 2000 ist.

BOOL  Is_Win2000()
{
  OSVERSIONINFOEX osvi;
  DWORDLONG dwlConditionMask = 0;

  // Initialize the OSVERSIONINFOEX structure.

  ZeroMemory(&osvi, sizeof(OSVERSIONINFOEX));
  osvi.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEX);
  osvi.dwMajorVersion = 5;
  osvi.dwMinorVersion = 0;

  // Initialize the condition mask.
  VER_SET_CONDITION( dwlConditionMask, VER_MAJORVERSION, VER_EQUAL );
  VER_SET_CONDITION( dwlConditionMask, VER_MINORVERSION, VER_EQUAL );

  // Perform the test.
  return VerifyVersionInfo(
      &osvi,
      VER_MAJORVERSION | VER_MINORVERSION,
      dwlConditionMask);
}

Für einen Monitor, der unter Windows 2000 geladen wird, legt der folgende Code den cbSize-Member der MONITOR2-Struktur entsprechend fest.

if ( Is_Win2000( ) )
    Monitor2.cbSize = MONITOR2_SIZE_WIN2K;

Anforderungen

Weitere Informationen

InitializePrintMonitor2

MONITORUI