Função CreateControlInputEx (corewindow.h)

Artigo
06/27/2024

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 pai CoreWindow 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 UUID para ICoreInputSourceBase, a interface padrão de 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 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 passado não for igual ao CoreWindow presente no thread de chamada.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	corewindow.h
de DLL	Windows.UI.dll

Consulte também

ICoreInputSourceBase

CoreComponentInputSource

Compartilhar via