CreateControlInputEx function
Creates a ICoreInputSourceBase object in a worker thread or the UI thread.
Syntax
HRESULT WINAPI CreateControlInputEx(
_In_ IUnknown *pCoreWindow,
_In_ REFIID riid,
_Out_ _COM_Outptr_ void **ppv
);
Parameters
- pCoreWindow [in]
-
Pointer to the parent CoreWindow to which the ICoreInputSourceBase object will be attached. This parameter can’t be NULL.
- riid [in]
-
Interface ID of the object. Must to be set to the UUID for ICoreInputSourceBase, which is 9F488807-4580-4BE8-BE68-92A9311713BB.
- ppv [out]
-
Pointer to receive the ICoreInputSourceBase object.
Return value
If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
This API must be called from the UI thread or worker thread to create ICoreInputSourceBase object. The object created using this API can be used only in that thread in which it was created.
If the call is successful, the caller can call QueryInterface on the returned ICoreInputSourceBase object to obtain the ICoreInputInterop object that created it.
This API will fail if the following scenarios occur:
- The pCoreWindow parameter is NULL.
- If the CoreWindow passed is not same as the CoreWindow present in the calling thread.
Requirements
|
Header |
|
|---|---|
|
DLL |
|
See also