Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

Creates a cache for the event sound player plug-ins and populates it with the registered event sound player plug-in objects.

Syntax

HRESULT InitializeEventSoundPlayerCache(void);

Return Value

Returns S_OKon successful initialization of the cache.

Remarks

This function creates a cache for the event sound player plug-ins and populates it with the registered event sound player plug-in objects. It maintains a single reference-counted cache for each process. Each process must create its own cache. This function is thread-safe and can be called by any thread to initialize the cache for the process.

Whenever an event sound player is needed to play a sound, the device will search the cache first. If a suitable player is found in the cache, it will be used, otherwise a new player is created. However, it is not necessary to create a cache in order to use the event sound functions.

To free the cached player objects, call UninitializeEventSoundPlayerCache.

Requirements

Header eventsound.h
Library eventsnd.lib

See Also