SB AWE32 Developer's Information Pack
PART III Windows Driver API
••
75
Copyright
Creative Technology Ltd., 1994-1996
Version 3.00
AWE_ERR_INVALID_SAMPE
Indicates application try to load an invalid sample
using AWE_VIENNA_LOAD_SAMPLE.
AWE_ERR_OUT_OF_DRAM
Indicates that the AWE32 hardware doesn't have
enough RAM to hold the user sample.
AWE_ERR_OUT_OF_GCHANNEL
Indicates that MIDI driver is run of channels to
be allocated to play user samples.
AWE_ERR_INVALID_PRESET
Indicates that application try to load an invalid
preset using AWE_VIENNA_LOAD_PRESET.
Windows Programming Guide
This chapter provides you with examples on how to use the API provided by AWEMAN. The examples
provided, in fragments of code, are sufficient to let you start accessing and manipulating the Sound
Blaster AWE32. This guide will show, in step by step examples, how the AWE32 features can be
programmed using the DLL provided.
This guide assumes that you are proficient in 'C' and Windows programming basics. The code present in
the examples assume that the DLL is statically linked to your program.
This chapter consists of the following sections :
•
Opening and closing the DLL
•
Query for support
•
Retrieving selections
•
Issuing selections
Opening and closing
The first step in your application is to obtain the AWE device by calling the API provided in the
AWEMAN.DLL. This can be done during your program's initialization in WinMain.
#include "windows.h"
#include "AWE_DLL.H"
/* Global variables */
extern AWEHANDLE hDeviceID;
.
.
int PASCAL WinMain (
HANDLE hInst,
HANDLE hPrevInst,
LPSTR lpCmdLine,
int nCmdShow )
{
MSG msg;
LRESULT lResult;
HWND hWnd;
WORD num;
.
.
/* Perform your program's initialization and create main window */