Share via


CreateControlInputEx 関数 (corewindow.h)

ワーカー スレッドまたは UI スレッドに ICoreInputSourceBase オブジェクトを作成します。

構文

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

パラメーター

[in] pCoreWindow

ICoreInputSourceBase オブジェクトがアタッチされる親 CoreWindow へのポインター。 このパラメーターを NULL にすることはできません。

[in] riid

オブジェクトのインターフェイス ID。 ICoreInputSourceBase の UUID (9F488807-4580-4BE8-BE68-92A9311713BB) に設定する必要があります。

[out] ppv

ICoreInputSourceBase オブジェクトを受け取るポインター。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

ICoreInputSourceBase オブジェクトを作成するには、UI スレッドまたはワーカー スレッドからこの API を呼び出す必要があります。 この API を使用して作成されたオブジェクトは、作成されたスレッドでのみ使用できます。

呼び出しが成功した場合、呼び出し元は、返された ICoreInputSourceBase オブジェクトで QueryInterface を呼び出して、それを作成した ICoreInputInterop オブジェクトを取得できます。

次のシナリオが発生した場合、この API は失敗します。

  • pCoreWindow パラメーターは NULL です
  • 渡された CoreWindow が呼び出し元スレッドに存在する CoreWindow と同じでない場合。

要件

要件
対象プラットフォーム Windows
ヘッダー corewindow.h
[DLL] Windows.UI.dll

こちらもご覧ください

ICoreInputSourceBase