Skip to content

Latest commit

 

History

History
123 lines (94 loc) · 4.23 KB

nf-mpconfig-imixerpinconfig-getrelativeposition.md

File metadata and controls

123 lines (94 loc) · 4.23 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:mpconfig.IMixerPinConfig.GetRelativePosition
IMixerPinConfig::GetRelativePosition (mpconfig.h)
The GetRelativePosition method retrieves the position of the stream in the display window.
GetRelativePosition
GetRelativePosition method [DirectShow]
GetRelativePosition method [DirectShow]
IMixerPinConfig interface
IMixerPinConfig interface [DirectShow]
GetRelativePosition method
IMixerPinConfig.GetRelativePosition
IMixerPinConfig::GetRelativePosition
IMixerPinConfigGetRelativePosition
dshow.imixerpinconfig_getrelativeposition
mpconfig/IMixerPinConfig::GetRelativePosition
dshow\imixerpinconfig_getrelativeposition.htm
dshow
0a2bcc3e-361d-4374-9444-717287c07116
4/26/2023
GetRelativePosition, GetRelativePosition method [DirectShow], GetRelativePosition method [DirectShow],IMixerPinConfig interface, IMixerPinConfig interface [DirectShow],GetRelativePosition method, IMixerPinConfig.GetRelativePosition, IMixerPinConfig::GetRelativePosition, IMixerPinConfigGetRelativePosition, dshow.imixerpinconfig_getrelativeposition, mpconfig/IMixerPinConfig::GetRelativePosition
mpconfig.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Strmiids.lib
Windows
19H1
IMixerPinConfig::GetRelativePosition
mpconfig/IMixerPinConfig::GetRelativePosition
c++
APIRef
kbSyntax
COM
Strmiids.lib
Strmiids.dll
IMixerPinConfig.GetRelativePosition

IMixerPinConfig::GetRelativePosition

-description

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The GetRelativePosition method retrieves the position of the stream in the display window.

-parameters

-param pdwLeft [out]

Pointer to a value indicating the x-coordinate in the top-left corner of the display window.

-param pdwTop [out]

Pointer to a value indicating the y-coordinate in the top-left corner of the display window.

-param pdwRight [out]

Pointer to a value indicating the x-coordinate in the bottom-right corner of the display window.

-param pdwBottom [out]

Pointer to a value indicating the y-coordinate in the bottom-right corner of the display window.

-returns

Returns an HRESULT value. Possible values include the following:

Return code Description
E_INVALIDARG
Coordinates not in the {0, 0, 10,000, 10,000} range.
S_OK
Success.

-remarks

This method assumes window coordinates of {0, 0, 10,000, 10,000}. If the video stream is being rendered in the bottom right quarter of the display window, this method would return {5,000, 5,000, 10,000, 10,000}.

-see-also

Error and Success Codes

IMixerPinConfig Interface

IMixerPinConfig::SetRelativePosition