#include "precomp.h"

Include dependency graph for devicelist.c:

Functions
MMRESULT	AllocateSoundDevice (IN MMDEVICE_TYPE DeviceType, OUT PSOUND_DEVICE *SoundDevice)

VOID	FreeSoundDevice (IN PSOUND_DEVICE SoundDevice)

ULONG	GetSoundDeviceCount (IN MMDEVICE_TYPE DeviceType)

BOOLEAN	IsValidSoundDevice (IN PSOUND_DEVICE SoundDevice)

MMRESULT	ListSoundDevice (IN MMDEVICE_TYPE DeviceType, IN PVOID Identifier OPTIONAL, OUT PSOUND_DEVICE *SoundDevice OPTIONAL)

MMRESULT	UnlistSoundDevice (IN MMDEVICE_TYPE DeviceType, IN PSOUND_DEVICE SoundDevice)

MMRESULT	UnlistSoundDevices (IN MMDEVICE_TYPE DeviceType)

VOID	UnlistAllSoundDevices ()

MMRESULT	GetSoundDevice (IN MMDEVICE_TYPE DeviceType, IN DWORD DeviceIndex, OUT PSOUND_DEVICE *SoundDevice)

MMRESULT	GetSoundDeviceIdentifier (IN PSOUND_DEVICE SoundDevice, OUT PVOID *Identifier)

MMRESULT	GetSoundDeviceType (IN PSOUND_DEVICE SoundDevice, OUT PMMDEVICE_TYPE DeviceType)

Variables
ULONG	SoundDeviceCounts [SOUND_DEVICE_TYPES]

PSOUND_DEVICE	SoundDeviceListHeads [SOUND_DEVICE_TYPES]

PSOUND_DEVICE	SoundDeviceListTails [SOUND_DEVICE_TYPES]

Function Documentation

◆ AllocateSoundDevice()

MMRESULT AllocateSoundDevice	(	IN MMDEVICE_TYPE	DeviceType,
		OUT PSOUND_DEVICE *	SoundDevice
	)

Definition at line 21 of file devicelist.c.

{
    PSOUND_DEVICE NewDevice;
 
    SND_ASSERT( IsValidSoundDeviceType(DeviceType) );
    SND_ASSERT( SoundDevice );
 
    SND_TRACE(L"Allocating a SOUND_DEVICE structure\n");
 
    NewDevice = AllocateStruct(SOUND_DEVICE);
 
    if ( ! NewDevice )
        return MMSYSERR_NOMEM;
 
    NewDevice->Type = DeviceType;
 
    /* Return the new structure to the caller and report success */
    *SoundDevice = NewDevice;
 
    return MMSYSERR_NOERROR;
}

Referenced by ListSoundDevice().

◆ FreeSoundDevice()

VOID FreeSoundDevice ( IN PSOUND_DEVICE SoundDevice )

Definition at line 49 of file devicelist.c.

{
    SND_ASSERT( SoundDevice );
 
    SND_TRACE(L"Freeing a SOUND_DEVICE structure");
 
    /* For safety the whole struct gets zeroed */
    ZeroMemory(SoundDevice, sizeof(SOUND_DEVICE));
    FreeMemory(SoundDevice);
}

Referenced by UnlistSoundDevice().

◆ GetSoundDevice()

MMRESULT GetSoundDevice	(	IN MMDEVICE_TYPE	DeviceType,
		IN DWORD	DeviceIndex,
		OUT PSOUND_DEVICE *	SoundDevice
	)

Definition at line 289 of file devicelist.c.

{
    UCHAR TypeIndex = SOUND_DEVICE_TYPE_TO_INDEX(DeviceType);
    DWORD CurrentIndex = 0;
    PSOUND_DEVICE CurrentDevice;
 
    VALIDATE_MMSYS_PARAMETER( IsValidSoundDeviceType(DeviceType) );
 
    if ( DeviceIndex >= SoundDeviceCounts[TypeIndex] )
    {
        SND_ERR(L"Invalid device ID %d for type %d\n", DeviceIndex, DeviceType);
        return MMSYSERR_BADDEVICEID;
    }
 
    CurrentDevice = SoundDeviceListHeads[TypeIndex];
 
    /* Following the earlier checks, the index should be valid here. */
    for ( CurrentIndex = 0; CurrentIndex != DeviceIndex; ++ CurrentIndex )
    {
        SND_ASSERT( CurrentDevice );
        CurrentDevice = CurrentDevice->Next;
    }
 
    SND_TRACE(L"Returning sound device %x\n", CurrentDevice);
 
    *SoundDevice = CurrentDevice;
 
    return MMSYSERR_NOERROR;
}

Referenced by MmeGetDeviceInterfaceString(), MmeGetLineInfo(), MmeGetSoundDeviceCapabilities(), and MmeOpenDevice().

◆ GetSoundDeviceCount()

ULONG GetSoundDeviceCount ( IN MMDEVICE_TYPE DeviceType )

Definition at line 67 of file devicelist.c.

{
    ULONG Index = SOUND_DEVICE_TYPE_TO_INDEX(DeviceType);
 
    if ( ! IsValidSoundDeviceType(DeviceType) )
    {
        return 0;
    }
 
    SND_TRACE(L"Returning a count of %d devices\n", SoundDeviceCounts[Index]);
    return SoundDeviceCounts[Index];
}

Referenced by auxMessage(), midMessage(), modMessage(), mxdMessage(), widMessage(), and wodMessage().

◆ GetSoundDeviceIdentifier()

MMRESULT GetSoundDeviceIdentifier	(	IN PSOUND_DEVICE	SoundDevice,
		OUT PVOID *	Identifier
	)

Definition at line 328 of file devicelist.c.

{
    VALIDATE_MMSYS_PARAMETER( SoundDevice );
    VALIDATE_MMSYS_PARAMETER( Identifier );
 
    /* The caller should not modify this! */
    *Identifier = SoundDevice->Identifier;
 
    return MMSYSERR_NOERROR;
}

Referenced by OpenNt4KernelSoundDevice(), and WdmAudSetWaveDeviceFormatByLegacy().

◆ GetSoundDeviceType()

MMRESULT GetSoundDeviceType	(	IN PSOUND_DEVICE	SoundDevice,
		OUT PMMDEVICE_TYPE	DeviceType
	)

Definition at line 346 of file devicelist.c.

{
    VALIDATE_MMSYS_PARAMETER( SoundDevice );
    VALIDATE_MMSYS_PARAMETER( DeviceType );
 
    *DeviceType = SoundDevice->Type;
 
    return MMSYSERR_NOERROR;
}

Referenced by CompleteIO(), CompleteWaveHeader(), DoWaveStreaming(), GetNt4SoundDeviceCapabilities(), GetSoundBlasterDeviceCapabilities(), GetSoundDeviceCapabilities(), MmeCloseDevice(), QueryWaveDeviceFormatSupport(), SetWaveDeviceFormat(), StopStreaming(), StopStreamingInSoundThread(), WdmAudCloseSoundDeviceByLegacy(), WdmAudCloseSoundDeviceByMMixer(), WdmAudCommitWaveBufferByLegacy(), WdmAudCommitWaveBufferByMMixer(), WdmAudGetCapabilitiesByLegacy(), WdmAudGetCapabilitiesByMMixer(), WdmAudGetWavePositionByLegacy(), WdmAudSetWaveDeviceFormatByLegacy(), WdmAudSetWaveDeviceFormatByMMixer(), WdmAudSetWaveStateByLegacy(), and WdmAudSetWaveStateByMMixer().

◆ IsValidSoundDevice()

BOOLEAN IsValidSoundDevice ( IN PSOUND_DEVICE SoundDevice )

Definition at line 87 of file devicelist.c.

{
    UCHAR TypeIndex;
    PSOUND_DEVICE CurrentDevice;
 
    if ( ! SoundDevice )
        return FALSE;
 
    /* Go through all the device lists */
    for ( TypeIndex = 0; TypeIndex < SOUND_DEVICE_TYPES; ++ TypeIndex )
    {
        CurrentDevice = SoundDeviceListHeads[TypeIndex];
 
        while ( CurrentDevice )
        {
            if ( CurrentDevice == SoundDevice )
            {
                /* Found the device */
                return TRUE;
            }
 
            CurrentDevice = CurrentDevice->Next;
        }
    }
 
    /* If we get here, nothing was found */
    return FALSE;
}

Referenced by CreateSoundDeviceInstance(), GetSoundDeviceCapabilities(), GetSoundDeviceFunctionTable(), ListSoundDeviceInstance(), OpenNt4KernelSoundDevice(), OpenNt4SoundDevice(), QueryNt4WaveDeviceFormatSupport(), QueryWaveDeviceFormatSupport(), SetSoundDeviceFunctionTable(), and UnlistSoundDevice().

◆ ListSoundDevice()

MMRESULT ListSoundDevice	(	IN MMDEVICE_TYPE	DeviceType,
		IN PVOID Identifier	OPTIONAL,
		OUT PSOUND_DEVICE *SoundDevice	OPTIONAL
	)

Definition at line 131 of file devicelist.c.

{
    MMRESULT Result;
    PSOUND_DEVICE NewDevice;
    UCHAR TypeIndex = SOUND_DEVICE_TYPE_TO_INDEX(DeviceType);
 
    VALIDATE_MMSYS_PARAMETER( IsValidSoundDeviceType(DeviceType) );
 
    Result = AllocateSoundDevice(DeviceType, &NewDevice);
 
    if ( ! MMSUCCESS(Result) )
    {
        SND_ERR(L"Failed to allocate SOUND_DEVICE structure\n");
        return Result;
    }
 
    if ( ! SoundDeviceListHeads[TypeIndex] )
    {
        SND_TRACE(L"Putting first entry into device list %d\n", DeviceType);
        SoundDeviceListHeads[TypeIndex] = NewDevice;
        SoundDeviceListTails[TypeIndex] = NewDevice;
    }
    else
    {
        SND_TRACE(L"Putting another entry into device list %d\n", DeviceType);
        SoundDeviceListTails[TypeIndex]->Next = NewDevice;
        SoundDeviceListTails[TypeIndex] = NewDevice;
    }
 
    /* Add to the count */
    ++ SoundDeviceCounts[TypeIndex];
 
    /* Set up the default function table */
    SetSoundDeviceFunctionTable(NewDevice, NULL);
 
    /* Set up other members of the structure */
    NewDevice->Identifier = Identifier;
    NewDevice->HeadInstance = NULL;
    NewDevice->TailInstance = NULL;
 
    /* Fill in the caller's PSOUND_DEVICE */
    if ( SoundDevice )
    {
        *SoundDevice = NewDevice;
    }
 
    return MMSYSERR_NOERROR;
}

Referenced by FoundDevice(), and PopulateWdmDeviceList().

◆ UnlistAllSoundDevices()

VOID UnlistAllSoundDevices ( )

Definition at line 270 of file devicelist.c.

{
    MMDEVICE_TYPE Type;
 
    SND_TRACE(L"Unlisting all sound devices\n");
 
    for ( Type = MIN_SOUND_DEVICE_TYPE; Type <= MAX_SOUND_DEVICE_TYPE; ++ Type )
    {
        MMRESULT Result;
        Result = UnlistSoundDevices(Type);
        SND_ASSERT( Result == MMSYSERR_NOERROR );
    }
}

Referenced by DriverProc().

◆ UnlistSoundDevice()

MMRESULT UnlistSoundDevice	(	IN MMDEVICE_TYPE	DeviceType,
		IN PSOUND_DEVICE	SoundDevice
	)

Definition at line 188 of file devicelist.c.

{
    PSOUND_DEVICE CurrentDevice, PreviousDevice;
 
    UCHAR TypeIndex = SOUND_DEVICE_TYPE_TO_INDEX(DeviceType);
 
    VALIDATE_MMSYS_PARAMETER( IsValidSoundDeviceType(DeviceType) );
    VALIDATE_MMSYS_PARAMETER( IsValidSoundDevice(SoundDevice) );
 
    PreviousDevice = NULL;
    CurrentDevice = SoundDeviceListHeads[TypeIndex];
 
    while ( CurrentDevice )
    {
        if ( CurrentDevice == SoundDevice )
        {
            if ( ! PreviousDevice )
            {
                /* This is the head node */
                SND_TRACE(L"Removing head node from device list %d\n", DeviceType);
                SoundDeviceListHeads[TypeIndex] =
                    SoundDeviceListHeads[TypeIndex]->Next;
            }
            else
            {
                SND_TRACE(L"Removing node from device list %d\n", DeviceType);
                /* There are nodes before this one - cut our device out */
                PreviousDevice->Next = CurrentDevice->Next;
            }
 
            if ( ! CurrentDevice->Next )
            {
                /* This is the tail node */
                SND_TRACE(L"Removing tail node from device list %d\n", DeviceType);
                SoundDeviceListTails[TypeIndex] = PreviousDevice;
            }
        }
 
        PreviousDevice = CurrentDevice;
        CurrentDevice = CurrentDevice->Next;
    }
 
    /* Subtract from the count */
    -- SoundDeviceCounts[TypeIndex];
 
    /* Finally, free up the deleted entry */
    FreeSoundDevice(SoundDevice);
 
    return MMSYSERR_NOERROR;
}

Referenced by UnlistSoundDevices().

◆ UnlistSoundDevices()

MMRESULT UnlistSoundDevices ( IN MMDEVICE_TYPE DeviceType )

Definition at line 245 of file devicelist.c.

{
    UCHAR TypeIndex;
    VALIDATE_MMSYS_PARAMETER( IsValidSoundDeviceType(DeviceType) );
 
    SND_TRACE(L"Unlisting all sound devices of type %d\n", DeviceType);
 
    TypeIndex = SOUND_DEVICE_TYPE_TO_INDEX(DeviceType);
 
    /* Munch away at the head of the list until it's drained */
    while ( SoundDeviceCounts[TypeIndex] > 0 )
    {
        MMRESULT Result;
        Result = UnlistSoundDevice(DeviceType, SoundDeviceListHeads[TypeIndex]);
        SND_ASSERT( Result == MMSYSERR_NOERROR );
    }
 
    return MMSYSERR_NOERROR;
}