SoundCreateDeviceName

NTSTATUS
   SoundCreateDeviceName(
       PCWSTR
PrePrefix,
       PCWSTR
Prefix,
       UCHAR 
Index,
       PUNICODE_STRING
DeviceName
       );

The SoundCreateDeviceName function creates a device name from the specified component parts.

Parameters

PrePrefix

Pointer to a string to prepend to the string pointed to by Prefix. Typically, this string is “\Device\” or “\DosDevices\”.

Prefix

Pointer to a string containing the main part of the name. Typically, this is the PrototypeName member of a SOUND_DEVICE_INIT structure.

Index

Number to append to the device name. Specify 0xFF if an index number should not be appended.

DeviceName

Pointer to a UNICODE_STRING structure, which receives the constructed name string.

Return Value

Returns one of the following values.

Value Definition
STATUS_SUCCESS Operation succeeded.
STATUS_INSUFFICIENT_RESOURCES Could not allocate string buffer.