Поделиться через


Функция CreateControlInputEx (corewindow.h)

Создает объект CoreComponentInputSource в рабочем потоке или потоке пользовательского интерфейса.

Синтаксис

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

Параметры

[in] pCoreWindow

Указатель на родительский CoreWindow, к которому будет присоединен объект CoreComponentInputSource. Этот параметр не может иметь значение NULL.

[in] riid

Идентификатор интерфейса объекта. Необходимо задать идентификатор UUID для ICoreInputSourceBase, стандартный интерфейс CoreComponentInputSource, который 9F488807-4580-4BE8-BE68-92A9311713BB.

[out] ppv

Указатель на получение объекта CoreComponentInputSource.

Возвращаемое значение

Если эта функция выполнена успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT.

Замечания

Этот API должен вызываться из потока пользовательского интерфейса или рабочего потока, чтобы создать объект ICoreInputSourceBase. Объект, созданный с помощью этого API, можно использовать только в этом потоке, в котором он был создан.

Если вызов выполнен успешно, вызывающий объект может вызывать QueryInterface в возвращен ном объекте ICoreInputSourceBase, чтобы получить объект ICoreInputInterop.

Этот API завершится ошибкой, если происходят следующие сценарии:

  • Параметр pCoreWindowNULL.
  • Если переданный CoreWindow не совпадает с CoreWindow, присутствующих в вызывающем потоке.

Требования

Требование Ценность
целевая платформа Виндоус
заголовка corewindow.h
DLL Windows.UI.dll

См. также

ICoreInputSourceBase

CoreComponentInputSource