Función CreateControlInputEx (corewindow.h)

Crea un objeto CoreComponentInputSource en un subproceso de trabajo o en el subproceso de interfaz de usuario.

Sintaxis

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

Parámetros

[in] pCoreWindow

Puntero al principal CoreWindow al que se asociará el objeto CoreComponentInputSource. Este parámetro no puede ser NULL.

[in] riid

Id. de interfaz del objeto. Debe establecerse en el UUID de ICoreInputSourceBase, la interfaz predeterminada de CoreComponentInputSource, que es 9F488807-4580-4BE8-BE68-92A9311713BB.

[out] ppv

Puntero para recibir el objeto CoreComponentInputSource.

Valor devuelto

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error.

Observaciones

Se debe llamar a esta API desde el subproceso de interfaz de usuario o el subproceso de trabajo para crear objeto ICoreInputSourceBase. El objeto creado con esta API solo se puede usar en ese subproceso en el que se creó.

Si la llamada se realiza correctamente, el autor de la llamada puede llamar a queryInterface en el objeto ICoreInputSourceBase devuelto para obtener el objeto ICoreInputInterop que lo creó.

Esta API producirá un error si se producen los siguientes escenarios:

• El parámetro pCoreWindow es NULL.
• Si el CoreWindow pasado no es el mismo que CoreWindow presente en el subproceso que realiza la llamada.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	corewindow.h
DLL de	Windows.UI.dll

Consulte también

ICoreInputSourceBase

CoreComponentInputSource