1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
//------------------------------------------------------------------------------
// File: MPConfig.h
//
// Desc:
//
// Copyright (c) 1997-2001, Microsoft Corporation. All rights reserved.
//------------------------------------------------------------------------------
#ifndef __IMPConfig__
#define __IMPConfig__
#ifdef __cplusplus
extern "C" {
#endif
typedef enum _AM_ASPECT_RATIO_MODE
{
AM_ARMODE_STRETCHED, // don't do any aspect ratio correction
AM_ARMODE_LETTER_BOX, // letter box the video, paint background color in the excess region
AM_ARMODE_CROP, // crop the video to the right aspect ratio
AM_ARMODE_STRETCHED_AS_PRIMARY // follow whatever the primary stream does (in terms of the mode as well as pict-aspect-ratio values)
} AM_ASPECT_RATIO_MODE;
DECLARE_INTERFACE_(IMixerPinConfig, IUnknown)
{
// this function sets the position of the stream in the display window, assuming
// that the window coordinates are {0, 0, 10000, 10000}. Thus giving arguments
// (0, 0, 5000, 5000) will put the stream in the top-left quarter. Any value greater
// than 10000 is invalid.
STDMETHOD (SetRelativePosition)(THIS_
IN DWORD dwLeft,
IN DWORD dwTop,
IN DWORD dwRight,
IN DWORD dwBottom
) PURE;
// this function gets the position of the stream in the display window, assuming
// that the window coordinates are {0, 0, 10000, 10000}. Thus if the values returned
// are (0, 0, 5000, 5000), then it means that the stream is in the top-left quarter.
STDMETHOD (GetRelativePosition)(THIS_
OUT DWORD *pdwLeft,
OUT DWORD *pdwTop,
OUT DWORD *pdwRight,
OUT DWORD *pdwBottom
) PURE;
// this function sets the ZOrder of the stream. The ZOrder of 0 is the closest
// to the eyes of the user, and increasing values imply greater distance.
STDMETHOD (SetZOrder)(THIS_
IN DWORD dwZOrder
) PURE;
// this function gets the ZOrder of the stream. The ZOrder of 0 is the closest
// to the eyes of the user, and increasing values imply greater distance.
STDMETHOD (GetZOrder)(THIS_
OUT DWORD *pdwZOrder
) PURE;
// this function sets the colorkey being used by the stream. Setting this value on the
// primary stream sets the destination colorkey being used by the overlay surface. Setting
// this value on the secondary pin makes sense only if the stream is transparent. By default
// the destination colorkey is used as the colorkey for all transparent (secondary) streams.
STDMETHOD (SetColorKey)(THIS_
IN COLORKEY *pColorKey
) PURE;
// this function gets the colorkey being used by the stream. Getting this value on the
// primary stream gets the destination colorkey being used by the overlay surface. Getting
// this value on the secondary pin returns the colorkey being used by that particular stream.
// When using this method, you are allowed to pass NULL for either pColorKey or pColor but
// not both.
STDMETHOD (GetColorKey)(THIS_
OUT COLORKEY *pColorKey,
OUT DWORD *pColor
) PURE;
// this function sets the blending parameter which in turn defines, how the secondary stream
// is going to be blended with the primary stream. A value of 0 makes the secondary stream
// invisible, a value of 255 makes the primary stream invisible (in that region only ofcourse),
// and any value inbetween, say x, blends the secondary and primary streams in the ratio x : (255-x).
// If no value is set, the default is 255.
// Any value less than 0 or greater than 255 is invalid. Calling this function on the primary
// stream would result in a return value of E_UNEXPECTED.
STDMETHOD (SetBlendingParameter)(THIS_
IN DWORD dwBlendingParameter
) PURE;
// this function gets the blending parameter which in turn defines, how the secondary stream
// is currently being blended with the primary stream.
STDMETHOD (GetBlendingParameter)(THIS_
OUT DWORD *pdwBlendingParameter
) PURE;
// this function is used to set the Aspect Ratio Correction mode on the pin.
// If the mode is set to letter box, black color is painted on the excess region
STDMETHOD (SetAspectRatioMode)(THIS_
IN AM_ASPECT_RATIO_MODE amAspectRatioMode
) PURE;
// this function is used to get the Aspect Ratio Correction mode on the pin.
STDMETHOD (GetAspectRatioMode)(THIS_
OUT AM_ASPECT_RATIO_MODE* pamAspectRatioMode
) PURE;
// this function sets the stream to be transparent. That means that the stream is not going
// to occupy the whole of the rectangle (specified by SetRelativePosition), some of the region
// is going to be transparent i.e. the stream underneath, is going to see through.
// Calling this function on the primary stream would result in a return value of E_UNEXPECTED.
STDMETHOD (SetStreamTransparent)(THIS_
IN BOOL bStreamTransparent
) PURE;
// this function is used to tell whether the stream is transparent or not.
STDMETHOD (GetStreamTransparent)(THIS_
OUT BOOL *pbStreamTransparent
) PURE;
};
DECLARE_INTERFACE_(IMixerPinConfig2, IMixerPinConfig)
{
// this functions sets the color-controls, if the vga chip supports it.
STDMETHOD (SetOverlaySurfaceColorControls)(THIS_
IN LPDDCOLORCONTROL pColorControl
) PURE;
// this functions gets the color-controls. It also returns the capability of the vga hardware
// in the dwFlags value of the struct.
STDMETHOD (GetOverlaySurfaceColorControls)(THIS_
OUT LPDDCOLORCONTROL pColorControl
) PURE;
};
#ifdef __cplusplus
}
#endif
#endif // #define __IMPConfig__
|
