#include <debug.h>
#include <ntddk.h>

Include dependency graph for sndblst.h:

This graph shows which files directly or indirectly include this file:

Classes
struct	_SOUND_BLASTER_PARAMETERS

Macros
#define	SB_WAVE_IN_DEVICE_NAME L"\\Device\\SBWaveIn"

#define	SB_WAVE_OUT_DEVICE_NAME L"\\Device\\SBWaveOut"

#define	SB_AUX_DEVICE_NAME L"\\Device\\SBAux"

#define	SB_MIXER_DEVICE_NAME L"\\Device\\SBMixer"

#define	DEFAULT_PORT 0x220

#define	DEFAULT_IRQ 5

#define	DEFAULT_DMA 1

#define	DEFAULT_BUFFER_SIZE 65535

#define	SB_TIMEOUT 1000000

#define	SB_DSP_READY 0xaa

#define	SbWrite(sbdevice, subport, data) WRITE_PORT_UCHAR((PUCHAR) sbdevice->port + subport, data)

#define	SbRead(sbdevice, subport) READ_PORT_UCHAR((PUCHAR) sbdevice->port + subport)

#define	SbWriteReset(sbdevice, data) SbWrite(sbdevice, SB_RESET_PORT, data)

#define	SbWriteDataWithoutWait(sbdevice, data) SbWrite(sbdevice, SB_WRITE_DATA_PORT, data)

#define	SbReadDataWithoutWait(sbdevice) SbRead(sbdevice, SB_READ_DATA_PORT)

#define	SbGetWriteStatus(sbdevice) SbRead(sbdevice, SB_WRITE_STATUS_PORT)

#define	SbGetReadStatus(sbdevice) SbRead(sbdevice, SB_READ_STATUS_PORT)

#define	WaitToWrite(sbdevice) WaitForReady(sbdevice, SB_WRITE_STATUS_PORT)

#define	WaitToRead(sbdevice) WaitForReady(sbdevice, SB_READ_STATUS_PORT)

Typedefs
typedef struct _SOUND_BLASTER_PARAMETERS	SOUND_BLASTER_PARAMETERS

typedef struct _SOUND_BLASTER_PARAMETERS *	PSOUND_BLASTER_PARAMETERS

typedef NTAPI NTSTATUS	REGISTRY_CALLBACK_ROUTINE(PDRIVER_OBJECT DriverObject, PWSTR RegistryPath)

typedef REGISTRY_CALLBACK_ROUTINE *	PREGISTRY_CALLBACK_ROUTINE

Enumerations
enum	{ NotDetected , SoundBlaster , SoundBlasterPro , SoundBlaster2 , SoundBlasterPro2 , SoundBlasterProMCV , SoundBlaster16 }

enum	{ SB_RESET_PORT = 0x06 , SB_READ_DATA_PORT = 0x0a , SB_WRITE_DATA_PORT = 0x0c , SB_WRITE_STATUS_PORT = 0x0c , SB_READ_STATUS_PORT = 0x0e }

enum	{ SbAutoInitDmaOutput = 0x1c , SbAutoInitDmaInput = 0x2c , SbSetOutputRate = 0x41 , SbSetInputRate = 0x42 , SbSetBlockSize = 0x48 , SbPauseDac = 0x80 , SbPauseDmaOutput = 0xd0 , SbEnableSpeaker = 0xd1 , SbDisableSpeaker = 0xd3 , SbGetSpeakerStatus = 0xd8 , SbGetDspVersion = 0xe1 }

Functions
BOOLEAN	WaitForReady (PSOUND_BLASTER_PARAMETERS SBDevice, UCHAR Port)

BOOLEAN	ResetSoundBlaster (PSOUND_BLASTER_PARAMETERS SBDevice)

ULONG	GetSoundBlasterModel (PSOUND_BLASTER_PARAMETERS SBDevice)

BOOLEAN	IsSampleRateCompatible (PSOUND_BLASTER_PARAMETERS SBDevice, ULONG SampleRate)

BOOLEAN	SetOutputSampleRate (PSOUND_BLASTER_PARAMETERS SBDevice, ULONG SampleRate)

BOOLEAN	EnableSpeaker (PSOUND_BLASTER_PARAMETERS SBDevice)

BOOLEAN	DisableSpeaker (PSOUND_BLASTER_PARAMETERS SBDevice)

BOOLEAN	StartSoundOutput (PSOUND_BLASTER_PARAMETERS SBDevice, ULONG BitDepth, ULONG Channels, ULONG BlockSize)

NTSTATUS	EnableIrq (PDEVICE_OBJECT DeviceObject)

Macro Definition Documentation

◆ DEFAULT_BUFFER_SIZE

#define DEFAULT_BUFFER_SIZE 65535

Definition at line 15 of file sndblst.h.

◆ DEFAULT_DMA

#define DEFAULT_DMA 1

Definition at line 14 of file sndblst.h.

◆ DEFAULT_IRQ

#define DEFAULT_IRQ 5

Definition at line 13 of file sndblst.h.

◆ DEFAULT_PORT

#define DEFAULT_PORT 0x220

Definition at line 12 of file sndblst.h.

◆ SB_AUX_DEVICE_NAME

#define SB_AUX_DEVICE_NAME L"\\Device\\SBAux"

Definition at line 9 of file sndblst.h.

◆ SB_DSP_READY

#define SB_DSP_READY 0xaa

Definition at line 19 of file sndblst.h.

◆ SB_MIXER_DEVICE_NAME

#define SB_MIXER_DEVICE_NAME L"\\Device\\SBMixer"

Definition at line 10 of file sndblst.h.

◆ SB_TIMEOUT

#define SB_TIMEOUT 1000000

Definition at line 17 of file sndblst.h.

◆ SB_WAVE_IN_DEVICE_NAME

#define SB_WAVE_IN_DEVICE_NAME L"\\Device\\SBWaveIn"

Definition at line 6 of file sndblst.h.

◆ SB_WAVE_OUT_DEVICE_NAME

#define SB_WAVE_OUT_DEVICE_NAME L"\\Device\\SBWaveOut"

Definition at line 7 of file sndblst.h.

◆ SbGetReadStatus

#define SbGetReadStatus ( sbdevice ) SbRead(sbdevice, SB_READ_STATUS_PORT)

Definition at line 96 of file sndblst.h.

◆ SbGetWriteStatus

#define SbGetWriteStatus ( sbdevice ) SbRead(sbdevice, SB_WRITE_STATUS_PORT)

Definition at line 93 of file sndblst.h.

◆ SbRead

#define SbRead	(	sbdevice,
		subport
	)	READ_PORT_UCHAR((PUCHAR) sbdevice->port + subport)

Definition at line 80 of file sndblst.h.

◆ SbReadDataWithoutWait

#define SbReadDataWithoutWait ( sbdevice ) SbRead(sbdevice, SB_READ_DATA_PORT)

Definition at line 89 of file sndblst.h.

◆ SbWrite

#define SbWrite	(	sbdevice,
		subport,
		data
	)	WRITE_PORT_UCHAR((PUCHAR) sbdevice->port + subport, data)

Definition at line 77 of file sndblst.h.

◆ SbWriteDataWithoutWait

#define SbWriteDataWithoutWait	(	sbdevice,
		data
	)	SbWrite(sbdevice, SB_WRITE_DATA_PORT, data)

Definition at line 86 of file sndblst.h.

◆ SbWriteReset

#define SbWriteReset	(	sbdevice,
		data
	)	SbWrite(sbdevice, SB_RESET_PORT, data)

Definition at line 83 of file sndblst.h.

◆ WaitToRead

#define WaitToRead ( sbdevice ) WaitForReady(sbdevice, SB_READ_STATUS_PORT)

Definition at line 109 of file sndblst.h.

◆ WaitToWrite

#define WaitToWrite ( sbdevice ) WaitForReady(sbdevice, SB_WRITE_STATUS_PORT)

Definition at line 106 of file sndblst.h.

Typedef Documentation

◆ PREGISTRY_CALLBACK_ROUTINE

typedef REGISTRY_CALLBACK_ROUTINE* PREGISTRY_CALLBACK_ROUTINE

Definition at line 70 of file sndblst.h.

◆ PSOUND_BLASTER_PARAMETERS

typedef struct _SOUND_BLASTER_PARAMETERS * PSOUND_BLASTER_PARAMETERS

◆ REGISTRY_CALLBACK_ROUTINE

typedef NTAPI NTSTATUS REGISTRY_CALLBACK_ROUTINE(PDRIVER_OBJECT DriverObject, PWSTR RegistryPath)

Definition at line 69 of file sndblst.h.

◆ SOUND_BLASTER_PARAMETERS

typedef struct _SOUND_BLASTER_PARAMETERS SOUND_BLASTER_PARAMETERS

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Enumerator
NotDetected
SoundBlaster
SoundBlasterPro
SoundBlaster2
SoundBlasterPro2
SoundBlasterProMCV
SoundBlaster16

Definition at line 21 of file sndblst.h.

{
    NotDetected,
    SoundBlaster,
    SoundBlasterPro,
    SoundBlaster2,
    SoundBlasterPro2,
    SoundBlasterProMCV,
    SoundBlaster16
};

◆ anonymous enum

anonymous enum

Enumerator
SB_RESET_PORT
SB_READ_DATA_PORT
SB_WRITE_DATA_PORT
SB_WRITE_STATUS_PORT
SB_READ_STATUS_PORT

Definition at line 32 of file sndblst.h.

{
    SB_RESET_PORT           = 0x06,
    SB_READ_DATA_PORT       = 0x0a,
    SB_WRITE_DATA_PORT      = 0x0c,
    SB_WRITE_STATUS_PORT    = 0x0c,
    SB_READ_STATUS_PORT     = 0x0e
};

◆ anonymous enum

anonymous enum

Enumerator
SbAutoInitDmaOutput
SbAutoInitDmaInput
SbSetOutputRate
SbSetInputRate
SbSetBlockSize
SbPauseDac
SbPauseDmaOutput
SbEnableSpeaker
SbDisableSpeaker
SbGetSpeakerStatus
SbGetDspVersion

Definition at line 41 of file sndblst.h.

{
    SbAutoInitDmaOutput     = 0x1c,
    SbAutoInitDmaInput      = 0x2c,
    SbSetOutputRate         = 0x41, /* DSP v4.xx */
    SbSetInputRate          = 0x42, /* DSP v4.xx */
    SbSetBlockSize          = 0x48, /* DSP v2.00 + */
    SbPauseDac              = 0x80,
    SbPauseDmaOutput        = 0xd0,
    SbEnableSpeaker         = 0xd1,
    SbDisableSpeaker        = 0xd3,
    SbGetSpeakerStatus      = 0xd8, /* DSP v2.00 + */
    SbGetDspVersion         = 0xe1
};

Function Documentation

◆ DisableSpeaker()

BOOLEAN DisableSpeaker ( PSOUND_BLASTER_PARAMETERS SBDevice )

Definition at line 167 of file control.c.

{
    DPRINT("Disabling speaker\n");
 
    return SbWriteData(SBDevice, SbDisableSpeaker);
}

◆ EnableIrq()

NTSTATUS EnableIrq ( PDEVICE_OBJECT DeviceObject )

Definition at line 27 of file interrupt.c.

{
    PSOUND_BLASTER_PARAMETERS parameters = DeviceObject->DeviceExtension;
    ULONG vector;
    KIRQL irq_level;
    KAFFINITY affinity;
    NTSTATUS status = STATUS_SUCCESS;
 
    vector = HalGetInterruptVector(Isa,
                                   0,
                                   parameters->irq,
                                   parameters->irq,
                                   &irq_level,
                                   &affinity);
 
    DPRINT("Vector is 0x%x\n", vector);
 
    status = IoConnectInterrupt(&parameters->interrupt,
                                ServiceSoundBlasterInterrupt,
                                DeviceObject,
                                (PKSPIN_LOCK) NULL,
                                vector,
                                irq_level,
                                irq_level,
                                Latched, /* Latched / LevelSensitive */
                                FALSE,  /* shareable */
                                affinity,
                                FALSE);
 
    if ( status == STATUS_INVALID_PARAMETER )
        status = STATUS_DEVICE_CONFIGURATION_ERROR;
 
    return status;
}

◆ EnableSpeaker()

BOOLEAN EnableSpeaker ( PSOUND_BLASTER_PARAMETERS SBDevice )

Definition at line 158 of file control.c.

{
    DPRINT("Enabling speaker\n");
 
    return SbWriteData(SBDevice, SbEnableSpeaker);
}

Referenced by CreateSoundBlaster(), and InitDevice().

◆ GetSoundBlasterModel()

ULONG GetSoundBlasterModel ( PSOUND_BLASTER_PARAMETERS SBDevice )

Definition at line 95 of file control.c.

{
    UCHAR MajorVer, MinorVer;
 
    DPRINT("Querying DSP version\n");
 
    if ( ! SbWriteData(SBDevice, SbGetDspVersion) )
        return NotDetected;
 
    if ( ! WaitToRead(SBDevice) )
        return NotDetected;
 
    if ( SbReadData(SBDevice, &MajorVer) )
    {
        if ( SbReadData(SBDevice, &MinorVer) )
        {
            DPRINT("Version %d.%d\n", MajorVer, MinorVer);
 
            SBDevice->dsp_version = (MajorVer * 256) + MinorVer;
 
            if ( SBDevice->dsp_version < 0x0200 )
                return SoundBlaster;
            else if ( ( SBDevice->dsp_version & 0xFF00 ) == 0x0200 )
                return SoundBlaster2;
            else if ( ( SBDevice->dsp_version & 0xFF00 ) == 0x0300 )
                return SoundBlasterPro;
            else if ( SBDevice->dsp_version >= 0x0400 )
                return SoundBlaster16;
 
            return NotDetected;
        }
    }
 
    return NotDetected;
}

◆ IsSampleRateCompatible()

BOOLEAN IsSampleRateCompatible	(	PSOUND_BLASTER_PARAMETERS	SBDevice,
		ULONG	SampleRate
	)

Definition at line 134 of file control.c.

{
    /* TODO */
    return TRUE;
}

◆ ResetSoundBlaster()

BOOLEAN ResetSoundBlaster ( PSOUND_BLASTER_PARAMETERS SBDevice )

Definition at line 59 of file control.c.

{
    BOOLEAN acked = FALSE;
    ULONG timeout;
 
    SbWriteReset(SBDevice, 0x01);
    for (timeout = 0; timeout < 30000; timeout ++ );
    SbWriteReset(SBDevice, 0x00);
 
    DPRINT("Waiting for SB to acknowledge our reset request\n");
 
    if ( ! WaitToRead(SBDevice) )
    {
        DPRINT("Didn't get an ACK :(\n");
        return FALSE;
    }
 
    timeout = 0;
 
    while ( ( ! acked ) && ( timeout < SB_TIMEOUT ) )
    {
        acked = ( SbReadDataWithoutWait(SBDevice) == SB_DSP_READY );
        timeout ++;
    }
 
    if ( ! acked )
    {
        DPRINT("Didn't get an ACK :(\n");
        return FALSE;
    }
 
    return TRUE;
}

Referenced by InitializeSoundBlaster().

◆ SetOutputSampleRate()

BOOLEAN SetOutputSampleRate	(	PSOUND_BLASTER_PARAMETERS	SBDevice,
		ULONG	SampleRate
	)

Definition at line 143 of file control.c.

{
    /* Only works for DSP v4.xx */
    DPRINT("Setting sample rate\n");
 
    SbWriteData(SBDevice, SbSetOutputRate);
    SbWriteData(SBDevice, SampleRate / 256);
    SbWriteData(SBDevice, SampleRate % 256);
 
    return TRUE;
}

Referenced by InitDevice().

◆ StartSoundOutput()

BOOLEAN StartSoundOutput	(	PSOUND_BLASTER_PARAMETERS	SBDevice,
		ULONG	BitDepth,
		ULONG	Channels,
		ULONG	BlockSize
	)

Definition at line 176 of file control.c.

{
    DPRINT("Initializing output with %d channels at %d bits/sample\n", Channels, BitDepth);
 
    UCHAR command = 0xc6, mode = 0x00;
 
    if ( ( Channels < 1 ) || ( Channels > 2 ) )
        return FALSE;
 
    if ( ( BitDepth != 8 ) && ( BitDepth != 16 ) )
        return FALSE;
 
    switch ( BitDepth )
    {
        case 8 :    command = 0xc6; break;
        case 16 :   command = 0xb6; break;
    };
 
    switch ( Channels )
    {
        case 1 :    mode = 0x00; break;
        case 2 :    mode = 0x20; break;
    }
#if 0
    first_byte = (BitDepth == 16) ? 0xb6 : 0xc6;
    second_byte = (Channels == 1) ? 0x20 : 0x00;
#endif
 
    if ( SBDevice->dsp_version < 0x0400 )
    {
        /* TODO: Additional programming required */
    }
 
    /* Send freq */
    SbWriteData(SBDevice, command);
    SbWriteData(SBDevice, mode);
    SbWriteData(SBDevice, BlockSize % 256);
    SbWriteData(SBDevice, BlockSize / 256);
 
    DPRINT("Finished programming the DSP\n");
 
    return TRUE;
}

◆ WaitForReady()

BOOLEAN WaitForReady	(	PSOUND_BLASTER_PARAMETERS	SBDevice,
		UCHAR	Port
	)

Definition at line 12 of file control.c.

{
    ULONG timeout = SB_TIMEOUT;
    BOOL ready = FALSE;
 
    while ( ( ! ready ) && ( timeout > 0 ) )
    {
        if ( SbRead(SBDevice, Port) & 0x80 )
            return TRUE;
 
        timeout --;
    }
 
    return FALSE;
}

Classes

Macros

Typedefs

Enumerations

Functions

Macro Definition Documentation

◆ DEFAULT_BUFFER_SIZE

◆ DEFAULT_DMA

◆ DEFAULT_IRQ

◆ DEFAULT_PORT

◆ SB_AUX_DEVICE_NAME

◆ SB_DSP_READY

◆ SB_MIXER_DEVICE_NAME

◆ SB_TIMEOUT

◆ SB_WAVE_IN_DEVICE_NAME

◆ SB_WAVE_OUT_DEVICE_NAME

◆ SbGetReadStatus

◆ SbGetWriteStatus

◆ SbRead

◆ SbReadDataWithoutWait

◆ SbWrite

◆ SbWriteDataWithoutWait

◆ SbWriteReset

◆ WaitToRead

◆ WaitToWrite

Typedef Documentation

◆ PREGISTRY_CALLBACK_ROUTINE

◆ PSOUND_BLASTER_PARAMETERS

◆ REGISTRY_CALLBACK_ROUTINE

◆ SOUND_BLASTER_PARAMETERS

Enumeration Type Documentation

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

Function Documentation

◆ DisableSpeaker()

◆ EnableIrq()

◆ EnableSpeaker()

◆ GetSoundBlasterModel()

◆ IsSampleRateCompatible()

◆ ResetSoundBlaster()

◆ SetOutputSampleRate()

◆ StartSoundOutput()

◆ WaitForReady()