control.c File Reference

#include "precomp.h"
#include <winioctl.h>
#include <ntddsnd.h>
#include <mmebuddy_debug.h>

Include dependency graph for control.c:

Go to the source code of this file.

Functions
MMRESULT	OpenNt4KernelSoundDevice (IN PSOUND_DEVICE SoundDevice, IN BOOLEAN ReadOnly, OUT PHANDLE Handle)
MMRESULT	OpenNt4SoundDevice (IN PSOUND_DEVICE SoundDevice, OUT PVOID *Handle)
MMRESULT	CloseNt4SoundDevice (IN PSOUND_DEVICE_INSTANCE SoundDeviceInstance, IN PVOID Handle)
MMRESULT	GetNt4SoundDeviceCapabilities (IN PSOUND_DEVICE SoundDevice, OUT PVOID Capabilities, IN DWORD CapabilitiesSize)
MMRESULT	QueryNt4WaveDeviceFormatSupport (IN PSOUND_DEVICE SoundDevice, IN LPWAVEFORMATEX Format, IN DWORD FormatSize)
MMRESULT	SetNt4WaveDeviceFormat (IN PSOUND_DEVICE_INSTANCE SoundDeviceInstance, IN DWORD DeviceId, IN LPWAVEFORMATEX Format, IN DWORD FormatSize)

Function Documentation

CloseNt4SoundDevice()

MMRESULT CloseNt4SoundDevice	(	IN PSOUND_DEVICE_INSTANCE	SoundDeviceInstance,
		IN PVOID	Handle
	)

Definition at line 65 of file control.c.

{
    SND_TRACE(L"Closing NT4 style sound device\n");
 
    VALIDATE_MMSYS_PARAMETER( IsValidSoundDeviceInstance(SoundDeviceInstance) );
    return CloseKernelSoundDevice((HANDLE) Handle);
}

Referenced by FoundDevice().

GetNt4SoundDeviceCapabilities()

MMRESULT GetNt4SoundDeviceCapabilities	(	IN PSOUND_DEVICE	SoundDevice,
		OUT PVOID	Capabilities,
		IN DWORD	CapabilitiesSize
	)

Definition at line 80 of file control.c.

{
    MMRESULT Result;
    MMDEVICE_TYPE DeviceType;
    DWORD IoCtl;
    HANDLE DeviceHandle;
 
    /* If these are bad there's an internal error with MME-Buddy! */
    SND_ASSERT( SoundDevice );
    SND_ASSERT( Capabilities );
    SND_ASSERT( CapabilitiesSize > 0 );
 
    SND_TRACE(L"NT4 get-capabilities routine called\n");
 
    /* Get the device type */
    Result = GetSoundDeviceType(SoundDevice, &DeviceType);
    SND_ASSERT( Result == MMSYSERR_NOERROR );
 
    if ( ! MMSUCCESS(Result) )
        return TranslateInternalMmResult(Result);
 
    /* Choose the appropriate IOCTL */
    if ( IS_WAVE_DEVICE_TYPE(DeviceType) )
    {
        IoCtl = IOCTL_WAVE_GET_CAPABILITIES;
    }
    else if ( IS_MIDI_DEVICE_TYPE(DeviceType) )
    {
        IoCtl = IOCTL_MIDI_GET_CAPABILITIES;
    }
    else
    {
        /* FIXME - need to support AUX and mixer devices */
        SND_ASSERT( FALSE );
        IoCtl = 0;
    }
 
    /* Get the capabilities information from the driver */
    Result = OpenNt4KernelSoundDevice(SoundDevice, TRUE, &DeviceHandle);
 
    if ( ! MMSUCCESS(Result) )
    {
        SND_ERR(L"Failed to open device");
        return TranslateInternalMmResult(Result);
    }
 
    Result = SyncOverlappedDeviceIoControl(DeviceHandle,
                                           IoCtl,
                                           Capabilities,
                                           CapabilitiesSize,
                                           NULL,
                                           0,
                                           NULL);
 
    CloseKernelSoundDevice(DeviceHandle);
 
    if ( ! MMSUCCESS(Result) )
    {
        SND_ERR(L"Retrieval of capabilities information failed\n");
        Result = TranslateInternalMmResult(Result);
    }
 
    return Result;
}

Referenced by GetSoundBlasterDeviceCapabilities().

OpenNt4KernelSoundDevice()

MMRESULT OpenNt4KernelSoundDevice	(	IN PSOUND_DEVICE	SoundDevice,
		IN BOOLEAN	ReadOnly,
		OUT PHANDLE	Handle
	)

Definition at line 22 of file control.c.

{
    PWSTR Path;
    MMRESULT Result;
 
    VALIDATE_MMSYS_PARAMETER( IsValidSoundDevice(SoundDevice) );
    VALIDATE_MMSYS_PARAMETER( Handle );
 
    Result = GetSoundDeviceIdentifier(SoundDevice, (PVOID*) &Path);
    if ( ! MMSUCCESS(Result) )
    {
        SND_ERR(L"Unable to get sound device path");
        return TranslateInternalMmResult(Result);
    }
 
    SND_ASSERT( Path );
 
    return OpenKernelSoundDeviceByName(Path, ReadOnly, Handle);
}

Referenced by GetNt4SoundDeviceCapabilities(), OpenNt4SoundDevice(), and QueryNt4WaveDeviceFormatSupport().

OpenNt4SoundDevice()

MMRESULT OpenNt4SoundDevice	(	IN PSOUND_DEVICE	SoundDevice,
		OUT PVOID *	Handle
	)

Definition at line 52 of file control.c.

{
    SND_TRACE(L"Opening NT4 style sound device\n");
 
    VALIDATE_MMSYS_PARAMETER( IsValidSoundDevice(SoundDevice) );
    VALIDATE_MMSYS_PARAMETER( Handle );
 
    return OpenNt4KernelSoundDevice(SoundDevice, FALSE, Handle);
}

Referenced by FoundDevice().

QueryNt4WaveDeviceFormatSupport()

MMRESULT QueryNt4WaveDeviceFormatSupport	(	IN PSOUND_DEVICE	SoundDevice,
		IN LPWAVEFORMATEX	Format,
		IN DWORD	FormatSize
	)

Definition at line 154 of file control.c.

{
    MMRESULT Result;
    HANDLE Handle;
 
    SND_TRACE(L"NT4 wave format support querying routine called\n");
 
    VALIDATE_MMSYS_PARAMETER( IsValidSoundDevice(SoundDevice) );
    VALIDATE_MMSYS_PARAMETER( Format );
    VALIDATE_MMSYS_PARAMETER( FormatSize >= sizeof(WAVEFORMATEX) );
 
    /* Get the device path */
    Result = OpenNt4KernelSoundDevice(SoundDevice,
                                      FALSE,
                                      &Handle);
 
    if ( ! MMSUCCESS(Result) )
    {
        SND_ERR(L"Unable to open kernel sound device\n");
        return TranslateInternalMmResult(Result);
    }
 
    Result = SyncOverlappedDeviceIoControl(Handle,
                                           IOCTL_WAVE_QUERY_FORMAT,
                                           (LPVOID) Format,
                                           FormatSize,
                                           NULL,
                                           0,
                                           NULL);
 
    if ( ! MMSUCCESS(Result) )
    {
        SND_ERR(L"Sync overlapped I/O failed - MMSYS_ERROR %d\n", Result);
        Result = TranslateInternalMmResult(Result);
    }
 
    CloseKernelSoundDevice(Handle);
 
    return MMSYSERR_NOERROR;
}

Referenced by FoundDevice().

SetNt4WaveDeviceFormat()

MMRESULT SetNt4WaveDeviceFormat	(	IN PSOUND_DEVICE_INSTANCE	SoundDeviceInstance,
		IN DWORD	DeviceId,
		IN LPWAVEFORMATEX	Format,
		IN DWORD	FormatSize
	)

Definition at line 199 of file control.c.

{
    MMRESULT Result;
    HANDLE Handle;
 
    VALIDATE_MMSYS_PARAMETER( IsValidSoundDeviceInstance(SoundDeviceInstance) );
    VALIDATE_MMSYS_PARAMETER( Format );
    VALIDATE_MMSYS_PARAMETER( FormatSize >= sizeof(WAVEFORMATEX) );
 
    Result = GetSoundDeviceInstanceHandle(SoundDeviceInstance, &Handle);
 
    if ( ! MMSUCCESS(Result) )
        return TranslateInternalMmResult(Result);
 
    SND_TRACE(L"Setting wave device format on handle %x\n", Handle);
 
    Result = SyncOverlappedDeviceIoControl(Handle,
                                           IOCTL_WAVE_SET_FORMAT,
                                           (LPVOID) Format,
                                           FormatSize,
                                           NULL,
                                           0,
                                           NULL);
 
    if ( ! MMSUCCESS(Result) )
        return TranslateInternalMmResult(Result);
 
    return MMSYSERR_NOERROR;
}

Referenced by FoundDevice().