DSEnumCallback

BOOL DSEnumCallback(GUID FAR * lpGuid,

LPSTR lpstrDescription, LPSTR lpstrModule,

LPVOID lpContext);

Application-defined callback function that enumerates the DirectSound drivers. The system calls this function in response to the application's previous call to the DirectSoundEnumerate function.

·Returns TRUE to continue enumerating drivers, or FALSE to stop.

lpGuid

Address of the GUID that identifies the DirectSound driver being enumerated. This value can be passed to the DirectSoundCreate function to create a DirectSound object for that driver.

lpstrDescription

Address of a null-terminated string that provides a textual description of the DirectSound device.

lpstrModule

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.

The application can save the strings passed in the lpstrDescription and lpstrModule parameters by copying them to memory that is allocated from the heap. The memory used to pass the strings to this callback function is valid only while this callback function is running.