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