CreateControlInputEx-Funktion (corewindow.h)

Erstellt ein CoreComponentInputSource -Objekt in einem Workerthread oder dem UI-Thread.

Syntax

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

Parameter

[in] pCoreWindow

Zeiger auf das übergeordnete CoreWindow-Objekt , 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 ICoreInputSourceBase, die Standardschnittstelle von CoreComponentInputSource, festgelegt werden.9F488807-4580-4BE8-BE68-92A9311713BB

[out] ppv

Zeiger zum Empfangen des CoreComponentInputSource-Objekts .

Rückgabewert

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

Bemerkungen

Diese API muss aus dem UI-Thread oder Workerthread aufgerufen werden, um ein 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 der übergebene CoreWindow nicht mit dem coreWindow übereinstimmt, der im aufrufenden Thread vorhanden ist.

Anforderungen

Siehe auch

ICoreInputSourceBase

CoreComponentInputSource