 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. |
DSEnumCallbackis an application-defined callback function that enumerates the DirectSound drivers. The system calls this function in response to the application's previous call to the DirectSoundEnumeratefunction.
BOOL CALLBACK DSEnumCallback( LPGUID lpGuid , LPCSTR lpcstrDescription , LPCSTR lpcstrModule , LPVOID lpContext );
Parameters
- lpGuid
- Address of the GUID that identifies the DirectSound driver being enumerated. This value can be passed to the DirectSoundCreatefunction to create a DirectSound object for that driver.
- lpcstrDescription
- Address of a null-terminated string that provides a textual description of the DirectSound device.
- lpcstrModule
- Address of a null-terminated string that specifies the module name of the DirectSound driver corresponding to this device.
- lpContext
- Address of application-defined data that is passed to each
callback function.
Return Values
Returns TRUE to continue enumerating drivers, or FALSE to stop.
Remarks
The application can save the strings passed in the lpcstrDescriptionand lpcstrModuleparameters by copying them to memory allocated from the heap. The memory used to pass the strings to this callback function is valid only while this callback function is running.
Requirements
Runs On Versions Defined in Include Link to Windows CE OS 2.12 or later. Version 2.12 requires DXPAK 1.0 or later. dsound.h dsound.lib Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also