在背景工作執行程或 UI 執行程中建立 CoreComponentInputSource 物件。
語法
HRESULT CreateControlInputEx(
[in] IUnknown *pCoreWindow,
[in] REFIID riid,
[out] void **ppv
);
參數
[in] pCoreWindow
指向 CoreComponentInputSource 物件將附加至的父 CoreWindow 指標。 此參數不可為 NULL。
[in] riid
對象的介面識別碼。 必須設定為 ICoreInputSourceBase 的 UUID,這是 CoreComponentInputSource 的預設介面,也就是 9F488807-4580-4BE8-BE68-92A9311713BB。
[out] ppv
接收 CoreComponentInputSource 物件的指標。
傳回值
如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
言論
必須從 UI 執行程或背景工作執行序呼叫此 API,才能建立 ICoreInputSourceBase 物件。 使用此 API 建立的物件只能用於建立該 API 的線程中。
如果呼叫成功,呼叫端可以在傳回的 ICoreInputSourceBase 物件上呼叫 QueryInterface,以取得建立它的 ICoreInputInterop 物件。
如果發生下列情況,此 API 將會失敗:
- pCoreWindow 參數為 Null。
- 如果傳遞的 CoreWindow 與呼叫執行程中存在的 CoreWindow 不同。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 窗戶 |
| Header | corewindow.h |
| Library | windows.ui.lib |
| DLL | Windows.UI.dll |