Méthode ITabletContextP::UseSharedMemoryCommunications
Fournit l’accès à la mémoire partagée entre les threads de tablette.
Syntaxe
HRESULT UseSharedMemoryCommunications(
[in] DWORD pid,
[out] DWORD *phEventMoreData,
[out] DWORD *phEventClientReady,
[out] DWORD *phMutexAccess,
[out] DWORD *phFileMapping
);
Paramètres
-
pid [in]
-
ID de processus.
-
phEventMoreData [out]
-
Handle d’événement qui signale quand de nouvelles données sont disponibles pour être traitées.
-
phEventClientReady [out]
-
Handle d’événement retourné utilisé pour signaler que le client est prêt à recevoir des données. Signalé après le traitement de nouvelles données.
-
phMutexAccess [out]
-
Mutex accordant l’accès à la mémoire partagée.
-
phFileMapping [out]
-
Pointeur vers le bloc de mémoire partagée.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
Opération réussie. |
|
Une erreur non spécifiée s'est produite. |
Notes
La méthode UseSharedMemoryCommunications est utilisée dans le cadre du protocole de mémoire partagée tablet PC. Étant donné que le service Wisptis a un niveau d’intégrité élevé (IL), il peut stocker et accéder aux données stockées dans la mémoire partagée sans avoir à élever ses privilèges.
La structure SHAREDMEMORY_HEADER est convertie à partir des données référencées par le mappage de fichiers et les données de paquet brutes suivent la SHAREDMEMORY_HEADER. Les données de paquet brutes peuvent être lues de la mémoire partagée lorsque l’événement référencé par pdwEventClientReady est déclenché.
La liste suivante décrit la séquence d’événements pour accéder à la mémoire partagée et l’utiliser.
- Le client définit l’événement clientReady.
- Le client attend l’événement moreData.
- Le client acquiert le mutex.
- Le client lit les données de paquets de la section de mémoire partagée après l’en-tête et les numéros de série après les paquets.
- Le client gère les données en fonction de la valeur de dwEvent.
- Le client écrit -1 (0xFFFFFFFF) dans dwEvent.
- Le client libère le mutex.
- Le client définit l’événement clientReady.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows XP Édition Tablette PC [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Aucun pris en charge |
| Bibliothèque |
|