typedef struct _MIDI_INFO
{
ULONG Key;
#define MIDI_INFO_KEY (*(ULONG *)"Midi")
KSPIN_LOCK DeviceSpinLock;
#if DBG
BOOLEAN LockHeld;
#endif
LARGE_INTEGER RefTime;
LIST_ENTRY QueueHead;
PVOID HwContext;
PMIDI_INTERFACE_ROUTINE HwStartMidiIn, HwStopMidiIn;
BOOLEAN (* HwMidiRead)(struct _MIDI_INFO *, PUCHAR);
VOID (* HwMidiOut)(struct _MIDI_INFO *, PUCHAR, int);
BOOLEAN fMidiInStarted;
UCHAR InputPosition;
UCHAR InputBytes;
UCHAR MidiInputByte[64];
} MIDI_INFO, *PMIDI_INFO;
The MIDI_INFO structure contains context information for an external MIDI device.
Members
Key
Internal only, for debugging. Should be “Midi”.
DeviceSpinLock
Internal only. Used for DPC synchronization.
LockHeld
Internal only. Used for debugging.
RefTime
Used by soundlib.lib to store the start time of an I/O operation, as reference for time stamps.
QueueHead
Internal only. Points to a buffer queue for MIDI input requests.
HwContext
Pointer to a driver-defined structure containing device-specific hardware information. Typically used by functions pointed to by the HwStartMidiIn, HwStopMidiIn, HwMidiRead, and HwMidiOut members.
HwStartMidiIn
Pointer to a driver-supplied function that programs the MIDI hardware to start recording. The function type is MIDI_INTERFACE_ROUTINE.
The function is called when SoundMIDIDispatch receives a IOCTL_MIDI_SET_STATE command. See \src\mmedia\soundlib\midi.c.
HwStopMidiIn
Pointer to a driver-supplied function that programs the MIDI hardware to stop recording. The function type is MIDI_INTERFACE_ROUTINE.
The function is called when SoundMIDIDispatch receives a IRP_MJ_CLEANUP command. For more information, see \src\mmedia\soundlib\midi.c.
HwMidiRead
Pointer to a driver-supplied function that reads one input byte. This operation might only consist of fetching the next byte from a buffer that was filled by an ISR. (An example is MPU401 support in sndblst.sys.) The function type is:
BOOLEAN (* HwMidiRead)(struct _MIDI_INFO *, PUCHAR)
The _MIDI_INFO* parameter points to a MIDI_INFO structure and the PUCHAR parameter receives the read byte. The function returns TRUE if a byte was read, and FALSE otherwise.
The function is called when SoundMIDIDispatch receives a IRP_MJ_READ command. For more information, see \src\mmedia\soundlib\midi.c.
This function executes at an IRQL of DISPATCH_LEVEL, so it cannot be pageable and it cannot reference pageable code or data. Also, the only synchronization method it can use is calling KeStallExecutionProcessor.
HwMidiOut
Pointer to a driver-supplied function that commands the MIDI hardware to write a string of bytes. Function type is:
VOID (* HwMidiOut)(struct _MIDI_INFO *, PUCHAR, int)
The first parameter points to a MIDI_INFO structure, the second parameter points to a mapped buffer of bytes, and the third parameter contains the buffer size.
The function is called when SoundMIDIDispatch receives a IOCTL_MIDI_PLAY command. For more information, see \src\mmedia\soundlib\midi.c.
fMidiInStarted
Internal only. Indicates a MIDI input operation is in progress.
InputPosition
Internal only. Pointer to an internal input buffer.
InputBytes
Internal only. Count of bytes in internal input buffer.
MidiInputByte
Internal only. Pointer to internal input buffer.
Comments
A single MIDI_INFO structure can be used to support simultaneous MIDI input and output. MIDI_INFO is defined in midi.h.
Allocate a MIDI_INFO structure from the nonpaged memory pool by calling ExAllocatePool, then zero it by calling RtlZeroMemory. To initialize a MIDI_INFO structure, call SoundInitMidiIn.
To create a MIDI device object, call SoundCreateDevice and specify a MIDI_INFO structure pointer for the DeviceSpecificData parameter.