Método ITabletContextP::UseSharedMemoryCommunications

Proporciona acceso a la memoria compartida entre subprocesos de tableta.

Sintaxis

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

Parámetros

pid [in]

Id. de proceso.

phEventMoreData [out]

El controlador de eventos indica cuándo hay nuevos datos disponibles para su procesamiento.

phEventClientReady [out]

Identificador de eventos devuelto que se usa para indicar que el cliente está listo para recibir datos. Señalizado después de procesar nuevos datos.

phMutexAccess [out]

Exclusión mutua que concede acceso a la memoria compartida.

phFileMapping [out]

Puntero al bloque de memoria compartida.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Correcto.
E_FAIL	Se ha producido un error no especificado.

Comentarios

El método UseSharedMemoryCommunications se usa como parte del protocolo de memoria compartida del pc tablet. Dado que el servicio Wisptis tiene un nivel de integridad alto (IL), puede almacenar y acceder a los datos almacenados en memoria compartida sin necesidad de elevar sus privilegios.

La estructura de SHAREDMEMORY_HEADER se convierte a partir de los datos a los que hace referencia la asignación de archivos y los datos de paquetes sin procesar siguen los SHAREDMEMORY_HEADER. Los datos de paquetes sin procesar se pueden leer de la memoria compartida cuando se genera el evento al que hace referencia pdwEventClientReady .

En la lista siguiente se describe la secuencia de eventos para acceder y usar la memoria compartida.

• El cliente establece el evento clientReady.
• El cliente espera el evento moreData.
• El cliente adquiere la exclusión mutua.
• El cliente lee los datos de paquetes de la sección de memoria compartida después del encabezado y los números de serie después de los paquetes.
• El cliente controla los datos en función del valor de dwEvent.
• El cliente escribe -1 (0xFFFFFFFF) en dwEvent.
• El cliente libera la exclusión mutua.
• El cliente establece el evento clientReady.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Biblioteca	Wisptis.exe

Consulte también

ITabletContextP (Interfaz)

UseNamedSharedMemoryCommunications