SoundSaveRegistryPath

NTSTATUS
SoundSaveRegistryPath(
IN PUNICODE_STRING
RegistryPathName,
OUT PWSTR
*SavedString
);

The SoundSaveRegistryPath function stores the specified registry path name, appends the \Parameters subkey to the name string, and returns a pointer to the stored string.

Parameters

RegistryPathName

Pointer to a registry path name. Typically, this is the path name received by the driver's DriverEntry function.

SavedString

Address of a location to receive a pointer to the new string.

Comments

Drivers use the returned path name when calling soundlib.lib functions that require a registry path name as input.

Prior to being unloaded, the driver must deallocate the buffer pointed to by SavedString.

The SoundSaveRegistryPath function is typically used by drivers that support only a single hardware device. Drivers supporting multiple devices call SoundEnumSubkeys, which appends \Parameters\DeviceNum to the path name.