📄 wavemain.cpp
字号:
//
// Copyright (c) Microsoft Corporation. All rights reserved.
//
//
// Use of this source code is subject to the terms of the Microsoft end-user
// license agreement (EULA) under which you licensed this SOFTWARE PRODUCT.
// If you did not accept the terms of the EULA, you are not authorized to use
// this source code. For a copy of the EULA, please see the LICENSE.RTF on your
// install media.
//
// -----------------------------------------------------------------------------
//
// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
// ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
// PARTICULAR PURPOSE.
//
// -----------------------------------------------------------------------------
#include "wavemain.h"
BOOL CALLBACK DllMain(HANDLE hDLL,
DWORD dwReason,
LPVOID lpvReserved)
{
switch (dwReason) {
case DLL_PROCESS_ATTACH :
DEBUGREGISTER((HINSTANCE)hDLL);
DisableThreadLibraryCalls((HMODULE) hDLL);
break;
case DLL_PROCESS_DETACH :
break;
case DLL_THREAD_DETACH :
break;
case DLL_THREAD_ATTACH :
break;
default :
break;
}
return TRUE;
}
// -----------------------------------------------------------------------------
//
// @doc WDEV_EXT
//
// @topic WAV Device Interface | Implements the WAVEDEV.DLL device
// interface. These functions are required for the device to
// be loaded by DEVICE.EXE.
//
// @xref <nl>
// <f WAV_Init>, <nl>
// <f WAV_Deinit>, <nl>
// <f WAV_Open>, <nl>
// <f WAV_Close>, <nl>
// <f WAV_Read>, <nl>
// <f WAV_Write>, <nl>
// <f WAV_Seek>, <nl>
// <f WAV_PowerUp>, <nl>
// <f WAV_PowerDown>, <nl>
// <f WAV_IOControl> <nl>
//
// -----------------------------------------------------------------------------
//
// @doc WDEV_EXT
//
// @topic Designing a Waveform Audio Driver |
// A waveform audio driver is responsible for processing messages
// from the Wave API Manager (WAVEAPI.DLL) to playback and record
// waveform audio. Waveform audio drivers are implemented as
// dynamic link libraries that are loaded by DEVICE.EXE The
// default waveform audio driver is named WAVEDEV.DLL (see figure).
// The messages passed to the audio driver are similar to those
// passed to a user-mode Windows NT audio driver (such as mmdrv.dll).
//
// <bmp blk1_bmp>
//
// Like all device drivers loaded by DEVICE.EXE, the waveform
// audio driver must export the standard device functions,
// XXX_Init, XXX_Deinit, XXX_IoControl, etc (see
// <t WAV Device Interface>). The Waveform Audio Drivers
// have a device prefix of "WAV".
//
// Driver loading and unloading is handled by DEVICE.EXE and
// WAVEAPI.DLL. Calls are made to <f WAV_Init> and <f WAV_Deinit>.
// When the driver is opened by WAVEAPI.DLL calls are made to
// <f WAV_Open> and <f WAV_Close>. On system power up and power down
// calls are made to <f WAV_PowerUp> and <f WAV_PowerDown>. All
// other communication between WAVEAPI.DLL and WAVEDEV.DLL is
// done by calls to <f WAV_IOControl>. The other WAV_xxx functions
// are not used.
//
// @xref <nl>
// <t Designing a Waveform Audio PDD> <nl>
// <t WAV Device Interface> <nl>
// <t Wave Input Driver Messages> <nl>
// <t Wave Output Driver Messages> <nl>
//
// -----------------------------------------------------------------------------
// -----------------------------------------------------------------------------
//
// @doc WDEV_EXT
//
// @func PVOID | WAV_Init | Device initialization routine
//
// @parm DWORD | dwInfo | info passed to RegisterDevice
//
// @rdesc Returns a DWORD which will be passed to Open & Deinit or NULL if
// unable to initialize the device.
//
// -----------------------------------------------------------------------------
extern "C" DWORD WAV_Init(DWORD Index)
{
return((DWORD)HardwareContext::CreateHWContext(Index));
}
// -----------------------------------------------------------------------------
//
// @doc WDEV_EXT
//
// @func PVOID | WAV_Deinit | Device deinitialization routine
//
// @parm DWORD | dwData | value returned from WAV_Init call
//
// @rdesc Returns TRUE for success, FALSE for failure.
//
// -----------------------------------------------------------------------------
extern "C" BOOL WAV_Deinit(DWORD dwData)
{
return(g_pHWContext->Deinit());
}
// -----------------------------------------------------------------------------
//
// @doc WDEV_EXT
//
// @func PVOID | WAV_Open | Device open routine
//
// @parm DWORD | dwData | Value returned from WAV_Init call (ignored)
//
// @parm DWORD | dwAccess | Requested access (combination of GENERIC_READ
// and GENERIC_WRITE) (ignored)
//
// @parm DWORD | dwShareMode | Requested share mode (combination of
// FILE_SHARE_READ and FILE_SHARE_WRITE) (ignored)
//
// @rdesc Returns a DWORD which will be passed to Read, Write, etc or NULL if
// unable to open device.
//
// -----------------------------------------------------------------------------
extern "C" PDWORD WAV_Open( DWORD dwData,
DWORD dwAccess,
DWORD dwShareMode)
{
// allocate and return handle context to efficiently verify caller trust level
return new DWORD(NULL); // assume untrusted. Can't tell for sure until WAV_IoControl
}
// -----------------------------------------------------------------------------
//
// @doc WDEV_EXT
//
// @func BOOL | WAV_Close | Device close routine
//
// @parm DWORD | dwOpenData | Value returned from WAV_Open call
//
// @rdesc Returns TRUE for success, FALSE for failure
//
// -----------------------------------------------------------------------------
extern "C" BOOL WAV_Close(PDWORD pdwData)
{
// we trust the device manager to give us a valid context to free.
delete pdwData;
return(TRUE);
}
// -----------------------------------------------------------------------------
//
// @doc WDEV_EXT
//
// @func DWORD | WAV_Read | Device read routine
//
// @parm DWORD | dwOpenData | Value returned from WAV_Open call (ignored)
//
// @parm LPVOID | pBuf | Buffer to receive data (ignored)
//
// @parm DWORD | len | Maximum length to read (ignored)
//
// @rdesc Returns 0 always. WAV_Read should never get called and does
// nothing. Required DEVICE.EXE function, but all data communication
// is handled by <f WAV_IOControl>.
//
// -----------------------------------------------------------------------------
extern "C" DWORD WAV_Read(DWORD dwData,
LPVOID pBuf,
DWORD Len)
{
// Return length read
return(0);
}
// -----------------------------------------------------------------------------
//
// @doc WDEV_EXT
//
// @func DWORD | WAV_Write | Device write routine
//
// @parm DWORD | dwOpenData | Value returned from WAV_Open call (ignored)
//
// @parm LPCVOID | pBuf | Buffer containing data (ignored)
//
// @parm DWORD | len | Maximum length to write (ignored)
//
// @rdesc Returns 0 always. WAV_Write should never get called and does
// nothing. Required DEVICE.EXE function, but all data communication
// is handled by <f WAV_IOControl>.
//
// -----------------------------------------------------------------------------
extern "C" DWORD WAV_Write(DWORD dwData,
LPCVOID pBuf,
DWORD Len)
{
// return number of bytes written (or -1 for error)
return(0);
}
// -----------------------------------------------------------------------------
//
// @doc WDEV_EXT
//
// @func DWORD | WAV_Seek | Device seek routine
//
// @parm DWORD | dwOpenData | Value returned from WAV_Open call (ignored)
//
// @parm long | pos | Position to seek to (relative to type) (ignored)
//
// @parm DWORD | type | FILE_BEGIN, FILE_CURRENT, or FILE_END (ignored)
//
// @rdesc Returns -1 always. WAV_Seek should never get called and does
// nothing. Required DEVICE.EXE function, but all data communication
// is handled by <f WAV_IOControl>.
//
// -----------------------------------------------------------------------------
extern "C" DWORD WAV_Seek(DWORD dwData,
long pos,
DWORD type)
{
// return an error
return((DWORD)-1);
}
// -----------------------------------------------------------------------------
//
// @doc WDEV_EXT
//
// @func void | WAV_PowerUp | Device powerup routine
//
// @comm Called to restore device from suspend mode. Cannot call any
// routines aside from those in the dll in this call.
//
// -----------------------------------------------------------------------------
extern "C" VOID WAV_PowerUp(VOID)
{
g_pHWContext->PowerUp();
return;
}
// -----------------------------------------------------------------------------
//
// @doc WDEV_EXT
//
// @func void | WAV_PowerDown | Device powerdown routine
//
// @comm Called to suspend device. Cannot call any routines aside from
// those in the dll in this call.
//
// -----------------------------------------------------------------------------
extern "C" VOID WAV_PowerDown(VOID)
{
g_pHWContext->PowerDown();
return;
}
BOOL HandleWaveMessage(PMMDRV_MESSAGE_PARAMS pParams, DWORD *pdwResult)
{
// set the error code to be no error first
SetLastError(MMSYSERR_NOERROR);
UINT uMsg = pParams->uMsg;
UINT uDeviceId = pParams->uDeviceId;
DWORD dwParam1 = pParams->dwParam1;
DWORD dwParam2 = pParams->dwParam2;
DWORD dwUser = pParams->dwUser;
StreamContext *pStreamContext = (StreamContext *)dwUser;
DWORD dwRet;
g_pHWContext->Lock();
switch (uMsg)
{
case WODM_GETNUMDEVS:
{
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -