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.