/*++ BUILD Version: 0001 // Increment this if a change has global effects
Copyright (c) 1992-1993 Microsoft Corporation
Module Name:
ntddmix.h
Abstract:
This include file defines all constants and types for
accessing a Windows NT sound mixer device.
Author:
Robin Speed (RobinSp) - 14-Sep-1993
Revision History:
--*/
#ifndef _NTDDMIX_
#define _NTDDMIX_
#include <ntddsnd.h> // general sound stuff
#define IOCTL_MIX_BASE 0x0180
//
// Device Name - this string is the name of the device. It is the name
// that when added to the name of the root of the device tree and with
// the device number appended, gives the name of the device required for
// a call to NtOpenFile.
// So for example, if the root is \Device and the Device type is
// MMMix and the device number is 2, the full name is \Device\MMMix2
//
#define DD_MIX_DEVICE_NAME "\\Device\\MMMix"
#define DD_MIX_DEVICE_NAME_U L"\\Device\\MMMix"
//
// Mixer device driver IOCTL set
// No caps call - the caps are dumped to the registry on load which saves
// some code and time.
//
#define IOCTL_MIX_GET_CONFIGURATION CTL_CODE(IOCTL_SOUND_BASE, IOCTL_MIX_BASE + 0x0001, METHOD_BUFFERED, FILE_READ_ACCESS)
#define IOCTL_MIX_GET_CONTROL_DATA CTL_CODE(IOCTL_SOUND_BASE, IOCTL_MIX_BASE + 0x0003, METHOD_BUFFERED, FILE_READ_ACCESS)
#define IOCTL_MIX_GET_LINE_DATA CTL_CODE(IOCTL_SOUND_BASE, IOCTL_MIX_BASE + 0x0004, METHOD_BUFFERED, FILE_READ_ACCESS)
#define IOCTL_MIX_REQUEST_NOTIFY CTL_CODE(IOCTL_SOUND_BASE, IOCTL_MIX_BASE + 0x0005, METHOD_BUFFERED, FILE_READ_ACCESS)
//
// mix structures
//
//
// IOCTL_MIX_GET_LINE_DATA and
// IOCTL_MIX_GET_CONTROL_DATA
//
// Line structure (NB LineID is implicit from location in array)
//
typedef struct {
ULONG Id; // Either Line or control ID
} MIXER_DD_READ_DATA, *PMIXER_DD_READ_DATA;
//
// Variable line data
//
typedef struct {
ULONG fdwLine;
} MIXER_DD_LINE_DATA;
typedef struct {
UCHAR Destination; // Destination
UCHAR Source; // Source (relative to destination)
UCHAR cChannels;
UCHAR cConnections; // Redundant
UCHAR cControls; // NB - redundant - could be deduced
// from the control set.
ULONG dwUser; // settable?
SHORT ShortNameStringId;
SHORT LongNameStringId;
ULONG dwComponentType; // SRC and DEST types
//
// Target information
//
USHORT Type;
USHORT wPid; // No USHORT !!!
SHORT PnameStringId; // Target product name
} MIXER_DD_LINE_CONFIGURATION_DATA, *PMIXER_DD_LINE_CONFIGURATION_DATA;
//
// Control structure (NB Control ID is implicit from location in array)
//
typedef struct {
ULONG dwControlType;
ULONG fdwControl;
UCHAR LineID;
UCHAR cMultipleItems;
SHORT ShortNameStringId;
SHORT LongNameStringId;
union
{
struct
{
LONG lMinimum; // signed minimum for this control
LONG lMaximum; // signed maximum for this control
};
struct
{
ULONG dwMinimum; // unsigned minimum for this control
ULONG dwMaximum; // unsigned maximum for this control
};
ULONG dwReserved[6];
} Bounds;
union
{
ULONG cSteps; // # of steps between min & max
ULONG cbCustomData; // size in bytes of custom data
ULONG dwReserved[6]; // !!! needed? we have cbStruct....
} Metrics;
ULONG TextDataOffset; // Offset to strings if any (or 0)
// Each string is indexed by a string id.
} MIXER_DD_CONTROL_CONFIGURATION_DATA, *PMIXER_DD_CONTROL_CONFIGURATION_DATA;
typedef struct {
ULONG dwParam1;
ULONG dwParam2;
SHORT SubControlTextStringId;
USHORT ControlId; // Debug cross reference.
} MIXER_DD_CONTROL_LISTTEXT, *PMIXER_DD_CONTROL_LISTTEXT;
//
// Capabilities data (using string id)
//
typedef struct {
USHORT wMid; // manufacturer id
USHORT wPid; // product id
MMVERSION vDriverVersion; // version of the driver
ULONG PnameStringId; // product name
ULONG fdwSupport; // misc. support bits
ULONG cDestinations; // count of destinations
} MIXER_DD_CAPS;
//
// The data dumped into the registry.
// The two counts are followed immediately by the appropriate number of
//
// MIXER_DD_LINE_CONFIGURATION_DATA and
//
// MIXER_DD_CONTROL_CONFIGURATION_DATA structures
//
// Next is the set of
//
// MIXER_DD_CONTROL_LISTTEXT structures ordered by control id.
//
// The MIXER_DD_LINE_CONFIGURATION_DATA structures must be ordered
// dest lines first (ie the destination lines have the lowest ids).
// The source lines must be ordered so that their destination lines
// either increase and stay the same - ie the sources for the first
// destination are first etc etc.
//
typedef struct {
ULONG cbSize; // Total size including this field
MIXER_DD_CAPS DeviceCaps; // Mixer device capabilities
ULONG NumberOfLines;
ULONG NumberOfControls;
} MIXER_DD_CONFIGURATION_DATA, *PMIXER_DD_CONFIGURATION_DATA;
//
//
// IOCTL_MIX_REQUEST_NOTIFY - use same data for input and output
// This request will continue to be completed until either
// SetCurrentLogicalTime is set or
//
// CurrentLogicalTime = Logical time of last change to mixer
// controls or lines.
//
// It will next be completed either when the device is closed or the
// next change is made to a control or line.
//
typedef struct {
LARGE_INTEGER CurrentLogicalTime; // Used by driver
BOOLEAN Initialized; // Set to 0 on first use
USHORT Message; // What sort of thing changed?
USHORT Id; // Id of thing that changed
} MIXER_DD_REQUEST_NOTIFY, *PMIXER_DD_REQUEST_NOTIFY;
//
// Data returned by IOCTL_MIX_GET_CAPABILITIES is MIXCAPSW structure
// defined in mmsystem.h
//
#endif // _NTDDMIX_
