CreateControlInputEx-Funktion (corewindow.h)

Artikel
06/27/2024

Erstellt ein CoreComponentInputSource -Objekt in einem Arbeitsthread oder ui-Thread.

Syntax

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

Parameter

[in] pCoreWindow

Zeiger auf das übergeordnete CoreWindow, an das das CoreComponentInputSource-Objekt angefügt wird. Dieser Parameter kann nicht NULL sein.

[in] riid

Schnittstellen-ID des Objekts. Muss auf die UUID für ICoreInputSourceBasefestgelegt werden, die Standardschnittstelle von CoreComponentInputSource, die 9F488807-4580-4BE8-BE68-92A9311713BBist.

[out] ppv

Zeiger zum Empfangen des CoreComponentInputSource-Objekts.

Rückgabewert

Wenn diese Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Bemerkungen

Diese API muss aus dem UI-Thread oder Workerthread aufgerufen werden, um ICoreInputSourceBase-Objekt zu erstellen. Das mit dieser API erstellte Objekt kann nur in diesem Thread verwendet werden, in dem es erstellt wurde.

Wenn der Aufruf erfolgreich ist, kann der Aufrufer QueryInterface- für das zurückgegebene ICoreInputSourceBase--Objekt aufrufen, um das ICoreInputInterop--Objekt abzurufen, das es erstellt hat.

Diese API schlägt fehl, wenn die folgenden Szenarien auftreten:

Der pCoreWindow-Parameter ist NULL-.
Wenn die übergebene CoreWindow- nicht mit dem CoreWindow- im aufrufenden Thread identisch ist.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	corewindow.h
DLL-	Windows.UI.dll

Siehe auch

ICoreInputSourceBase-

CoreComponentInputSource-

Freigeben über