Metodo ITabletContextP::UseSharedMemoryCommunications

Articolo
06/13/2023

Fornisce l'accesso alla memoria condivisa tra thread tablet.

Sintassi

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

Parametri

pid [in]: ID processo.
phEventMoreData [out]: Handle eventi che segnala quando sono disponibili nuovi dati da elaborare.
phEventClientReady [out]: Handle eventi restituito usato per segnalare che il client è pronto per ricevere i dati. Segnalato dopo l'elaborazione di nuovi dati.
phMutexAccess [out]: Mutex che concede l'accesso alla memoria condivisa.
phFileMapping [out]: Puntatore al blocco di memoria condivisa.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_FAIL	Si è verificato un errore non specificato.

Commenti

Il metodo UseSharedMemoryCommunications viene usato come parte del protocollo di memoria condivisa tablet PC. Poiché il servizio Wisptis ha un livello di integrità elevato (IL), può archiviare e accedere ai dati archiviati in memoria condivisa senza dover elevare i privilegi.

La struttura SHAREDMEMORY_HEADER viene eseguita dal cast dei dati a cui fa riferimento il mapping dei file e i dati dei pacchetti non elaborati seguono il SHAREDMEMORY_HEADER. I dati dei pacchetti non elaborati possono essere letti dalla memoria condivisa quando viene generato l'evento a cui fa riferimento pdwEventClientReady .

Nell'elenco seguente viene descritta la sequenza di eventi per l'accesso e l'uso della memoria condivisa.

Il client imposta l'evento clientReady.
Il client attende l'evento moreData.
Il client acquisisce il mutex.
Il client legge i dati dei pacchetti dalla sezione della memoria condivisa dopo l'intestazione e i numeri di serie dopo i pacchetti.
Il client gestisce i dati a seconda del valore di dwEvent.
Il client scrive -1 (0xFFFFFFFF) in dwEvent.
Il client rilascia il mutex.
Il client imposta l'evento clientReady.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Libreria	Wisptis.exe

Vedi anche

Interfaccia ITabletContextP
UseNamedSharedMemoryCommunications

Condividi tramite