Função CreateControlInputEx (corewindow.h)

Cria um objeto CoreComponentInputSource em um thread de trabalho ou no thread da interface do usuário.

Sintaxe

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

Parâmetros

[in] pCoreWindow

Ponteiro para o CoreWindow pai ao qual o objeto CoreComponentInputSource será anexado. Esse parâmetro não pode ser NULL.

[in] riid

ID da interface do objeto. Deve ser definido como a UUID para ICoreInputSourceBase, a interface padrão do CoreComponentInputSource, que é 9F488807-4580-4BE8-BE68-92A9311713BB.

[out] ppv

Ponteiro para receber o objeto CoreComponentInputSource .

Valor de retorno

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Observações

Essa API deve ser chamada do thread de interface do usuário ou thread de trabalho para criar o objeto ICoreInputSourceBase . O objeto criado usando essa API só pode ser usado nesse thread no qual foi criado.

Se a chamada for bem-sucedida, o chamador poderá chamar QueryInterface no objeto ICoreInputSourceBase retornado para obter o objeto ICoreInputInterop que o criou.

Essa API falhará se os seguintes cenários ocorrerem:

• O parâmetro pCoreWindow é NULL.
• Se o CoreWindow passou não for o mesmo que o CoreWindow presente no thread de chamada.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
Header	corewindow.h
Library	windows.ui.lib
de DLL	Windows.UI.dll

Consulte também

ICoreInputSourceBase

CoreComponentInputSource