CreateControlInputEx, fonction (corewindow.h)

Crée un objet CoreComponentInputSource dans un thread de travail ou le thread d’interface utilisateur.

Syntaxe

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

Paramètres

[in] pCoreWindow

Pointeur vers le CoreWindow parent auquel l’objet CoreComponentInputSource sera attaché. Ce paramètre ne peut pas être NULL.

[in] riid

ID d’interface de l’objet. Doit être défini sur l’UUID pour ICoreInputSourceBase, l’interface par défaut de CoreComponentInputSource, qui est 9F488807-4580-4BE8-BE68-92A9311713BB.

[out] ppv

Pointeur pour recevoir l’objet CoreComponentInputSource.

Valeur de retour

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un HRESULT code d’erreur.

Remarques

Cette API doit être appelée à partir du thread d’interface utilisateur ou du thread de travail pour créer objet ICoreInputSourceBase. L’objet créé à l’aide de cette API ne peut être utilisé que dans ce thread dans lequel il a été créé.

Si l’appel réussit, l’appelant peut appeler QueryInterface sur l’objet ICoreInputSourceBase retourné pour obtenir l’objet ICoreInputInterop qui l’a créé.

Cette API échoue si les scénarios suivants se produisent :

  • Le paramètre pCoreWindow est NULL.
  • Si la CoreWindow passée n’est pas identique à la CoreWindow présente dans le thread appelant.

Exigences

Exigence Valeur
plateforme cible Windows
d’en-tête corewindow.h
DLL Windows.UI.dll

Voir aussi

ICoreInputSourceBase

CoreComponentInputSource