ITabletContextP::UseSharedMemoryCommunications-Methode

Artikel
06/13/2023

Ermöglicht den Zugriff auf den zwischen Tablet-Threads freigegebenen 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. Signalisiert nach der Verarbeitung neuer Daten.
phMutexAccess [out]: Der Mutex, der Zugriff auf gemeinsam genutzten Arbeitsspeicher gewährt.
phFileMapping [out]: Zeiger auf den Shared Memory-Block.

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 Tablet PC-Shared Memory-Protokolls verwendet. Da der Wisptis-Dienst über einen hohen Integritätsgrad (IL) verfügt, kann er Daten speichern und darauf zugreifen, die im freigegebenen Arbeitsspeicher gespeichert sind, ohne seine Berechtigungen erhöhen zu müssen.

Die SHAREDMEMORY_HEADER-Struktur wird aus den Daten umgewandelt, auf die durch die Dateizuordnung verwiesen wird, und die rohen Paketdaten folgen dem SHAREDMEMORY_HEADER. Unformatierte Paketdaten können aus dem freigegebenen Arbeitsspeicher gelesen werden, wenn das ereignis, auf das von pdwEventClientReady verwiesen wird, ausgelöst wird.

In der folgenden Liste wird die Reihenfolge der Ereignisse für den Zugriff auf und die Verwendung von freigegebenem Arbeitsspeicher beschrieben.

Der Client legt das clientReady-Ereignis fest.
Der Client wartet auf das ereignis moreData.
Der Client ruft den Mutex ab.
Der Client liest Paketdaten aus dem Abschnitt des freigegebenen Arbeitsspeichers 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.

Anforderungen

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

Siehe auch

ITabletContextP-Schnittstelle
UseNamedSharedMemoryCommunications

Freigeben über