Skip to content

Latest commit

 

History

History
133 lines (105 loc) · 4.41 KB

nf-strmif-iamextdevice-calibrate.md

File metadata and controls

133 lines (105 loc) · 4.41 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:strmif.IAMExtDevice.Calibrate
IAMExtDevice::Calibrate (strmif.h)
The Calibrate method calibrates an external device's transport mechanism.
Calibrate
Calibrate method [DirectShow]
Calibrate method [DirectShow]
IAMExtDevice interface
IAMExtDevice interface [DirectShow]
Calibrate method
IAMExtDevice.Calibrate
IAMExtDevice::Calibrate
IAMExtDeviceCalibrate
dshow.iamextdevice_calibrate
strmif/IAMExtDevice::Calibrate
dshow\iamextdevice_calibrate.htm
dshow
0c760669-c494-45bb-994e-5b4599db7de4
4/26/2023
Calibrate, Calibrate method [DirectShow], Calibrate method [DirectShow],IAMExtDevice interface, IAMExtDevice interface [DirectShow],Calibrate method, IAMExtDevice.Calibrate, IAMExtDevice::Calibrate, IAMExtDeviceCalibrate, dshow.iamextdevice_calibrate, strmif/IAMExtDevice::Calibrate
strmif.h
Dshow.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Strmiids.lib
Windows
19H1
IAMExtDevice::Calibrate
strmif/IAMExtDevice::Calibrate
c++
APIRef
kbSyntax
COM
Strmiids.lib
Strmiids.dll
IAMExtDevice.Calibrate

IAMExtDevice::Calibrate

-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 Calibrate method calibrates an external device's transport mechanism.

This method is not implemented.

-parameters

-param hEvent [in]

Handle to an event. The event is signaled when the action is complete.

-param Mode [in]

Specifies a value that activates or deactivates the calibration process:

Value Description
ED_ACTIVE Activates the calibration process.
ED_INACTIVE Deactivates the calibration process.
NULL No action; return the calibration status in pStatus.

-param pStatus [out]

Pointer to a long integer that receives one of the following values:

Value Description
OATRUE Calibration is active.
OAFALSE Calibration is inactive.

-returns

When this method succeeds, it returns S_OK. Otherwise it returns an HRESULT error code.

-remarks

Use this method on certain external devices that require calibration; for example, rewinding a tape and resetting the counter, or computing the frame offset for a timecode reader.

Filters for various external devices can implement this method differently, depending on the calibration that the device needs. This method assumes the IMediaEventSink interface has already established an event sink, or that another event signaling method has been established.

DV Implementation

The MSDV and UVC drivers do not support this method. The method returns E_NOTIMPL.

-see-also

Error and Success Codes

IAMExtDevice Interface