共用方式為

ITabletCoNtextP：：UseSharedMemoryCommunications 方法

  • 發行項

提供平板電腦執行緒之間共用記憶體的存取權。

語法

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

參數

pid [in]

進程識別碼。

phEventMoreData [out]

事件控制碼，當新資料可供處理時發出訊號。

phEventClientReady [out]

傳回的事件控制碼，用來表示用戶端已準備好接收資料。 處理新資料之後發出訊號。

phMutexAccess [out]

Mutex 授與共享記憶體的存取權。

phFileMapping [out]

共用記憶體區塊的指標。

傳回值

這個方法可以傳回其中一個值。

傳回碼 描述
S_OK
 成功。
E_FAIL
 發生未指定的錯誤。

備註

UseSharedMemoryCommunications方法會當做平板電腦共用記憶體通訊協定的一部分使用。 由於 Wisptis 服務具有高完整性層級 (IL) ，因此可以儲存和存取儲存在共用記憶體中的資料，而不需要提高其許可權。

SHAREDMEMORY_HEADER結構會從檔案對應所參考的資料轉換，而原始封包資料會遵循SHAREDMEMORY_HEADER。 引發 pdwEventClientReady 所參考的事件時，可以讀取共用記憶體的原始封包資料。

下列清單描述存取和使用共用記憶體的事件順序。

  • 用戶端會設定 clientReady 事件。
  • 用戶端會等候 moreData 事件。
  • 用戶端會取得 mutex。
  • 用戶端會從標頭之後的共用記憶體區段讀取封包資料，並在封包之後讀取序號。
  • 用戶端會根據 dwEvent的值來處理資料。
  • 用戶端會將 -1 (0xFFFFFFFF) 寫入 dwEvent。
  • 用戶端會釋放 mutex。
  • 用戶端會設定 clientReady 事件。

規格需求

需求 值
最低支援的用戶端
 Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器
 都不支援
程式庫
Wisptis.exe

另請參閱

ITabletCoNtextP 介面

UseNamedSharedMemoryCommunications