windows-nt/Source/XPSP1/NT/enduser/netmeeting/av/nac/vcmcaps.h
2020-09-26 16:20:57 +08:00

282 lines
10 KiB
C++
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*
* File: vcmcaps.h
*
*
* VCM implementation of Microsoft Network Video capability object.
*
* Additional methods supported by this implementation:
*
* VIDEO_FORMAT_ID AddEncodeFormat(VIDCAP_DETAILS *pFmtBuf,LPVOID lpvMappingData, UINT uSize);
* VIDEO_FORMAT_ID AddDecodeFormat(VIDCAP_DETAILS *pFmtBuf,LPVOID lpvMappingData, UINT uSize);
*
* Revision History:
*
* 12/27/95 mikev created
* 07/28/96 philf added support for video
*/
#ifndef _VCMCAPS_H
#define _VCMCAPS_H
#include <pshpack8.h>
// VCM enumeration support functions
BOOL GetVideoFormatBuffer(VOID);
BOOL __stdcall FormatTagEnumCallback(HVCMDRIVERID hadid, PVCMFORMATTAGDETAILS paftd,
DWORD dwInstance, DWORD fdwSupport);
BOOL __stdcall FormatEnumCallback(HVCMDRIVERID hadid,
PVCMFORMATDETAILS pafd, DWORD_PTR dwInstance, DWORD fdwSupport);
BOOL __stdcall DriverEnumCallback(HVCMDRIVERID hadid,
DWORD_PTR dwInstance, DWORD fdwSupport);
#ifdef __cplusplus
class CVcmCapability
{
protected:
HACMDRIVER hAcmDriver;
DWORD m_dwDeviceID;
public:
CVcmCapability();
~CVcmCapability();
BOOL FormatEnum(CVcmCapability *pCapObject, DWORD dwFlags);
BOOL DriverEnum(CVcmCapability *pCapObject);
HACMDRIVER GetDriverHandle() {return hAcmDriver;};
virtual BOOL FormatEnumHandler(HVCMDRIVERID hadid,
PVCMFORMATDETAILS pafd, VCMDRIVERDETAILS *padd, DWORD_PTR dwInstance);
};
#define SQCIF 0x1
#define QCIF 0x2
#define CIF 0x4
#define UNKNOWN 0x8
#define get_format(w,h) ((w == 128 && h == 96 ) ? SQCIF : ((w == 176 && h == 144 )? QCIF: ((w == 352 && h == 288 ) ? CIF :UNKNOWN)))
#define NONSTD_VID_TERMCAP {H245_CAPDIR_LCLRX, H245_DATA_VIDEO,H245_CLIENT_VID_NONSTD, 0, {0}}
#define STD_VID_TERMCAP(tc) {H245_CAPDIR_LCLRX, H245_DATA_VIDEO,(tc), 0, {0}}
//Advertise the maximum possible rate, and assume we can do below this.
//H.261 defines a max MPI of 4!
#define STD_VID_PARAMS {0,0,1}
typedef struct VideoParameters
{
BYTE RTPPayload; // RTP payload type
DWORD dwFormatDescriptor; // the unique ID of this format
UINT uSamplesPerSec; // the number of frames per second
UINT uBitsPerSample; // the number of bits per pixel
VIDEO_SIZES enumVideoSize; // enum. Use Small, Medium, Large
UINT biWidth; // the frame width in pixels
UINT biHeight; // the frame height in pixels
}VIDEO_PARAMS;
typedef struct VidCapDetails
{
DWORD dwFormatTag;
CC_TERMCAP H245Cap;
NSC_CHANNEL_VIDEO_PARAMETERS nonstd_params;
VIDEO_PARAMS video_params; // this has a dependency on protocol.h
DWORD dwPublicRefIndex; // index of the local capability entry that will be
// advertized. Zero if this entry is the one to advertize
BOOL bSendEnabled;
BOOL bRecvEnabled;
DWORD dwDefaultSamples; // default number of samples per packet
UINT uMaxBitrate; // max bandwidth used by this format (calculated: bits per sample * sample rate)
UINT uAvgBitrate; // average bandwidth used by this format (we get this from the codec)
WORD wCPUUtilizationEncode;
WORD wCPUUtilizationDecode;
WORD wApplicationPrefOrder; // overriding preference - lower number means more preferred
UINT uLocalDetailsSize; // size in bytes of what lpLocalFormatDetails points to
LPVOID lpLocalFormatDetails;
UINT uRemoteDetailsSize; // size in bytes of what lpRemoteFormatDetails points to
LPVOID lpRemoteFormatDetails;
char szFormat[VCMFORMATDETAILS_FORMAT_CHARS];
} VIDCAP_DETAILS, *PVIDCAP_DETAILS;
/*
* VCM interface
* Definitions for interfacing with VCM
*/
typedef struct
{
PVIDCAP_DETAILS pVidcapDetails; // a pointer to an VIDCAP_DETAILS structure
DWORD dwFlags; // misc flags...
PVIDEOFORMATEX pvfx; // pointer to video format structure. used when adding formats
HRESULT hr;
} VCM_APP_PARAM, *PVCM_APP_PARAM;
//
// implementation class of the Video Interface
//
class CImpAppVidCap : public IAppVidCap
{
public:
STDMETHOD_(ULONG, AddRef());
STDMETHOD_(ULONG, Release());
STDMETHOD(GetNumFormats(UINT *puNumFmtOut));
STDMETHOD(ApplyAppFormatPrefs(PBASIC_VIDCAP_INFO pFormatPrefsBuf,
UINT uNumFormatPrefs));
STDMETHOD(EnumFormats(PBASIC_VIDCAP_INFO pFmtBuf, UINT uBufsize,
UINT *uNumFmtOut));
STDMETHOD(EnumCommonFormats(PBASIC_VIDCAP_INFO pFmtBuf, UINT uBufsize,
UINT *uNumFmtOut, BOOL bTXCaps));
STDMETHOD( GetBasicVidcapInfo (VIDEO_FORMAT_ID Id,
PBASIC_VIDCAP_INFO pFormatPrefsBuf));
STDMETHOD( AddVCMFormat (PVIDEOFORMATEX lpvfx, PVIDCAP_INFO pVidCapInfo));
STDMETHOD( RemoveVCMFormat (PVIDEOFORMATEX lpvfx));
STDMETHOD_ (PVIDEOFORMATEX, GetVidcapDetails(THIS_ VIDEO_FORMAT_ID Id));
STDMETHOD( GetPreferredFormatId (VIDEO_FORMAT_ID *pId));
STDMETHOD (SetDeviceID(DWORD dwDeviceID));
void Init(class CMsivCapability * pCapObject) {m_pCapObject = pCapObject;};
protected:
class CMsivCapability * m_pCapObject;
};
class CMsivCapability : public IH323MediaCap, public CVcmCapability
{
protected:
UINT uRef;
BOOL bPublicizeTXCaps;
BOOL bPublicizeTSTradeoff;
//LOOKLOOK this supports a hack to disable CPU intensive codecs if not running on a pentium
WORD wMaxCPU;
static MEDIA_FORMAT_ID IDsByRank[MAX_CAPS_PRESORT];
static UINT uNumLocalFormats; // # of active entries in pLocalFormats
static UINT uStaticRef; // global ref count
static UINT uCapIDBase; // rebase capability ID to index into IDsByRank
static VIDCAP_DETAILS *pLocalFormats; // cached list of formats that we can receive
static UINT uLocalFormatCapacity; // size of pLocalFormats (in multiples of VIDCAP_DETAILS)
PVIDCAP_DETAILS pRemoteDecodeFormats; // cached list of formats that the
// other end can receive/decode
UINT uNumRemoteDecodeFormats; // # of entries for remote decode capabilities
UINT uRemoteDecodeFormatCapacity; // size of pRemoteDecodeFormats (in multiples of VIDCAP_DETAILS)
PVCM_APP_PARAM m_pAppParam; // a pointer to a PVCM_APP_PARAM structure. Used to carry
// a information through the enumeration process
// but can be used for other purposes
//
// embedded interface classes
//
CImpAppVidCap m_IAppVidCap;
protected:
// Internal functions
UINT IDToIndex(MEDIA_FORMAT_ID id) {return id - uCapIDBase;};
MEDIA_FORMAT_ID IndexToId(UINT uIndex){return uIndex + uCapIDBase;};
LPTSTR AllocRegistryKeyName(LPTSTR lpDriverName,
UINT uSampleRate, UINT uBitsPerSample, UINT uBytesPerSec,UINT uWidth,UINT uHeight);
VOID FreeRegistryKeyName(LPTSTR lpszKeyName);
VOID CalculateFormatProperties(VIDCAP_DETAILS *pFmtBuf, PVIDEOFORMATEX lpvfx);
BOOL IsFormatSpecified(PVIDEOFORMATEX lpFormat, PVCMFORMATDETAILS pvfd,
VCMDRIVERDETAILS *pvdd, VIDCAP_DETAILS *pVidcapDetails);
virtual VOID SortEncodeCaps(SortMode sortmode);
virtual VIDEO_FORMAT_ID AddFormat(VIDCAP_DETAILS *pFmtBuf,LPVOID lpvMappingData, UINT uSize);
BOOL UpdateFormatInRegistry(VIDCAP_DETAILS *pFmt);
BOOL BuildFormatName( PVIDCAP_DETAILS pVidcapDetails,
WCHAR *pszDriverName,
WCHAR *pszFormatName);
HRESULT GetFormatName(PVIDCAP_DETAILS pVidcapDetails, PVIDEOFORMATEX pvfx);
public:
STDMETHOD_(BOOL, Init());
STDMETHOD_(BOOL, ReInit());
CMsivCapability();
~CMsivCapability();
// handler for codec enumeration callback
virtual BOOL FormatEnumHandler(HVCMDRIVERID hvdid,
PVCMFORMATDETAILS pvfd, VCMDRIVERDETAILS *pvdd, DWORD_PTR dwInstance);
//
// Common interface methods
//
STDMETHODIMP QueryInterface(REFIID riid, LPVOID FAR * ppvObj);
STDMETHOD_(ULONG, AddRef());
STDMETHOD_(ULONG, Release());
//
// IVCapApi methods
//
STDMETHOD(GetNumFormats(UINT *puNumFmtOut));
STDMETHOD(ApplyAppFormatPrefs(PBASIC_VIDCAP_INFO pFormatPrefsBuf,
UINT uNumFormatPrefs));
STDMETHOD(EnumFormats(PBASIC_VIDCAP_INFO pFmtBuf, UINT uBufsize,
UINT *uNumFmtOut));
STDMETHOD(EnumCommonFormats(PBASIC_VIDCAP_INFO pFmtBuf, UINT uBufsize,
UINT *uNumFmtOut, BOOL bTXCaps));
STDMETHOD( GetBasicVidcapInfo (VIDEO_FORMAT_ID Id,
PBASIC_VIDCAP_INFO pFormatPrefsBuf));
STDMETHOD( AddVCMFormat (PVIDEOFORMATEX lpvfx, PVIDCAP_INFO pVidCapInfo));
STDMETHOD( RemoveVCMFormat (PVIDEOFORMATEX lpvfx));
STDMETHOD( GetPreferredFormatId (VIDEO_FORMAT_ID *pId));
STDMETHOD (SetDeviceID(DWORD dwDeviceID)) {m_dwDeviceID = dwDeviceID; return hrSuccess;};
// support of IVCapApi methods
virtual HRESULT CopyVidcapInfo (PVIDCAP_DETAILS pDetails, PVIDCAP_INFO pInfo,
BOOL bDirection);
//
// IH323MediaCap methods
//
STDMETHOD_(VOID, FlushRemoteCaps());
STDMETHOD( AddRemoteDecodeCaps(PCC_TERMCAPLIST pTermCapList));
STDMETHOD_(VIDEO_FORMAT_ID, AddRemoteDecodeFormat(PCC_TERMCAP pCCThisCap));
// Get local and remote channel parameters for a specific encode capability
STDMETHOD( GetEncodeParams(LPVOID pBufOut, UINT uBufSize, LPVOID pLocalParams,
UINT uLocalSize,MEDIA_FORMAT_ID idRemote,MEDIA_FORMAT_ID idLocal));
STDMETHOD( GetPublicDecodeParams(LPVOID pBufOut, UINT uBufSize, VIDEO_FORMAT_ID id));
STDMETHOD( GetDecodeParams(PCC_RX_CHANNEL_REQUEST_CALLBACK_PARAMS pChannelParams,
VIDEO_FORMAT_ID * pFormatID, LPVOID lpvBuf, UINT uBufSize));
STDMETHOD_(UINT, GetNumCaps()){return uNumLocalFormats;};
STDMETHOD_(UINT, GetNumCaps(BOOL bRXCaps));
STDMETHOD_(BOOL, IsHostForCapID(MEDIA_FORMAT_ID CapID));
STDMETHOD_(BOOL, IsCapabilityRecognized(PCC_TERMCAP pCCThisCap));
STDMETHOD(SetCapIDBase(UINT uNewBase));
STDMETHOD_(UINT, GetCapIDBase()) {return uCapIDBase;};
STDMETHOD (IsFormatEnabled (MEDIA_FORMAT_ID FormatID, PBOOL bRecv, PBOOL bSend));
STDMETHOD_(BOOL, IsFormatPublic(MEDIA_FORMAT_ID FormatID));
STDMETHOD_(MEDIA_FORMAT_ID, GetPublicID(MEDIA_FORMAT_ID FormatID));
STDMETHOD_ (VOID, EnableTXCaps(BOOL bSetting)) {bPublicizeTXCaps = bSetting;};
STDMETHOD_ (VOID, EnableRemoteTSTradeoff(BOOL bSetting)) {bPublicizeTSTradeoff= bSetting;};
STDMETHOD (SetAudioPacketDuration( UINT durationInMs));
STDMETHOD (ResolveToLocalFormat(MEDIA_FORMAT_ID FormatIDLocal,
MEDIA_FORMAT_ID * pFormatIDRemote));
STDMETHOD_(UINT, GetLocalSendParamSize(MEDIA_FORMAT_ID dwID));
STDMETHOD_(UINT, GetLocalRecvParamSize(PCC_TERMCAP pCapability));
STDMETHOD( CreateCapList(LPVOID *ppCapBuf));
STDMETHOD( DeleteCapList(LPVOID pCapBuf));
STDMETHOD( ResolveEncodeFormat(VIDEO_FORMAT_ID *pIDVidEncodeOut,VIDEO_FORMAT_ID * pIDVidRemoteDecode));
// methods provided to the Data pump, common to H.323 and MSICCP
STDMETHOD(GetDecodeFormatDetails(MEDIA_FORMAT_ID FormatID, VOID **ppFormat, UINT *puSize));
STDMETHOD(GetEncodeFormatDetails(MEDIA_FORMAT_ID FormatID, VOID **ppFormat, UINT *puSize));
};
#endif // __cplusplus
#include <poppack.h>
#endif //#ifndef _VCMCAPS_H