CreateControlInputEx 函数 (corewindow.h)

在工作线程或 UI 线程中创建 CoreComponentInputSource 对象。

语法

HRESULT CreateControlInputEx(
  [in]  IUnknown *pCoreWindow,
  [in]  REFIID   riid,
  [out] void     **ppv
);

参数

[in] pCoreWindow

指向将附加 CoreComponentInputSource 对象的父 CoreWindow 的指针。 此参数不能为 NULL。

[in] riid

对象的接口 ID。 必须设置为 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 不同。

要求

要求 价值
目标平台 窗户
标头 corewindow.h
DLL Windows.UI.dll

另请参阅

ICoreInputSourceBase

CoreComponentInputSource