Microsoft Speech SDK SAPI 5.1

---

SpCreateDefaultObjectFromCategoryId

SpCreateDefaultObjectFromCategoryId creates the object instance from the default object token of a specified category.

Found in: sphelper.h

SpCreateDefaultObjectFromCategoryId(
   const WCHAR   *pszCategoryId,
   T            **ppObject,
   IUnknown      *pUnkOuter = NULL,
   DWORD          dwClsCtxt = CLSCTX_ALL
);

Parameters

pszCategoryId

[in] The type of object token to create.

ppObject

[out] The object being created.

pUnkOuter

[in] Optional parameter used for creating aggregate objects. pUnkOuter is the data for the object. If not specified, the value defaults to NULL.

dwClsCtxt

[in] The type of aggregate object being created. If pUnkOuter is not NULL, this must be supplied. If not specified otherwise, the value defaults to all object types.

Return values

Value	Description
S_OK	Function completed successfully.
FAILED (hr)	Appropriate error message.

Example

CComPtr<ISpAudio> cpAudio;
	
hr = SpCreateDefaultObjectFromCategoryId(SPCAT_AUDIOIN, &cpAudio;);