ITabletContextP::UseSharedMemoryCommunications-Methode

Ermöglicht den Zugriff auf den von Tabletthreads gemeinsam genutzten Arbeitsspeicher.

Syntax

HRESULT UseSharedMemoryCommunications(
  [in]  DWORD pid,
  [out] DWORD *phEventMoreData,
  [out] DWORD *phEventClientReady,
  [out] DWORD *phMutexAccess,
  [out] DWORD *phFileMapping
);

Parameter

Pid [ In]

Prozess-ID.

phEventMoreData [ out]

Ereignishandle, das signalisiert, wenn neue Daten zur Verarbeitung verfügbar sind.

phEventClientReady [ out]

Zurückgegebenes Ereignishandle, das verwendet wird, um zu signalisieren, dass der Client bereit ist, Daten zu empfangen. Wird nach der Verarbeitung neuer Daten signalisiert.

phMutexAccess [ out]

Der Mutex, der Zugriff auf freigegebenen Arbeitsspeicher gewährt.

phFileMapping [ out]

Zeiger auf den Freigegebenen Speicherblock.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S _ OK
Erfolg.
E _ FAIL
Es ist ein unbekannter Fehler aufgetreten.

Bemerkungen

Die UseSharedMemoryCommunications-Methode wird als Teil des Shared Memory-Protokolls für Tablet PC verwendet. Da der Wisptis-Dienst über eine hohe Integritätsebene (High Integrity Level, IL) verfügt, kann er daten, die im freigegebenen Speicher gespeichert sind, speichern und darauf zugreifen, ohne seine Berechtigungen erhöhen zu müssen.

Die SHAREDMEMORY _ HEADER-Struktur wird aus den Daten umgetauscht, auf die von der Dateizuordnung verwiesen wird, und die Unformatierungspaketdaten folgen dem SHAREDMEMORY _ HEADER. Unformatierte Paketdaten können aus dem freigegebenen Arbeitsspeicher gelesen werden, wenn das Ereignis ausgelöst wird, auf das von pdwEventClientReady verwiesen wird.

In der folgenden Liste wird die Abfolge von Ereignissen für den Zugriff auf und die Verwendung von freigegebenen Speicher beschrieben.

  • Der Client legt das clientReady-Ereignis fest.
  • Der Client wartet auf das moreData-Ereignis.
  • Der Client erhält den Mutex.
  • Der Client liest Paketdaten aus dem Abschnitt des freigegebenen Speichers nach dem Header und Seriennummern nach den Paketen.
  • Der Client verarbeitet Daten abhängig vom Wert von dwEvent.
  • Der Client schreibt -1 (0xFFFFFFFF) in dwEvent.
  • Der Client gibt den Mutex frei.
  • Der Client legt das clientReady-Ereignis fest.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur Desktop-Apps der XP Tablet PC Edition []
Unterstützte Mindestversion (Server)
Nicht unterstützt
Bibliothek
Wisptis.exe

Weitere Informationen

ITabletContextP-Schnittstelle

UseNamedSharedMemoryCommunications