Método ITabletContextP::UseSharedMemoryCommunications
Fornece acesso à memória compartilhada entre threads de tablet.
Sintaxe
HRESULT UseSharedMemoryCommunications(
[in] DWORD pid,
[out] DWORD *phEventMoreData,
[out] DWORD *phEventClientReady,
[out] DWORD *phMutexAccess,
[out] DWORD *phFileMapping
);
Parâmetros
-
pid [in]
-
ID do processo.
-
phEventMoreData [out]
-
Identificador de evento que sinaliza quando novos dados estão disponíveis para serem processados.
-
phEventClientReady [out]
-
Identificador de evento retornado usado para sinalizar que o cliente está pronto para receber dados. Sinalizado após o processamento de novos dados.
-
phMutexAccess [out]
-
O mutex que concede acesso à memória compartilhada.
-
phFileMapping [out]
-
Ponteiro para o bloco de memória compartilhada.
Valor retornado
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Ocorreu um erro não especificado. |
Comentários
O método UseSharedMemoryCommunications é usado como parte do protocolo de memória compartilhada tablet PC. Como o serviço Wisptis tem um IL (alto nível de integridade), ele pode armazenar e acessar dados armazenados na memória compartilhada sem a necessidade de elevar seus privilégios.
A estrutura SHAREDMEMORY_HEADER é convertida dos dados referenciados pelo mapeamento de arquivo e os dados brutos do pacote seguem o SHAREDMEMORY_HEADER. Os dados brutos do pacote podem ser lidos da memória compartilhada quando o evento referenciado por pdwEventClientReady é gerado.
A lista a seguir descreve a sequência de eventos para acessar e usar memória compartilhada.
- O cliente define o evento clientReady.
- O cliente aguarda o evento moreData.
- O cliente adquire o mutex.
- O cliente lê os dados do pacote da seção de memória compartilhada após o cabeçalho e os números de série após os pacotes.
- O cliente manipula dados dependendo do valor de dwEvent.
- O cliente grava -1 (0xFFFFFFFF) em dwEvent.
- O cliente libera o mutex.
- O cliente define o evento clientReady.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP Tablet PC Edition [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Nenhum compatível |
| Biblioteca |
|