IAMExtDevice::Calibrate メソッド (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

メソッドは Calibrate 、外部デバイスのトランスポート メカニズムを調整します。

このメソッドは実装されていません。

構文

HRESULT Calibrate(
  [in]  HEVENT hEvent,
  [in]  long   Mode,
  [out] long   *pStatus
);

パラメーター

[in] hEvent

イベントに対するハンドル。 アクションが完了すると、イベントが通知されます。

[in] Mode

調整プロセスをアクティブ化または非アクティブ化する値を指定します。

値	説明
ED_ACTIVE	調整プロセスをアクティブにします。
ED_INACTIVE	調整プロセスを非アクティブ化します。
NULL	アクションなし。は pStatus で調整状態を返します。

[out] pStatus

次のいずれかの値を受け取る 長整数 へのポインター。

値	説明
OATRUE	調整がアクティブです。
OAFALSE	調整が非アクティブです。

戻り値

このメソッドが成功すると、S_OKが返されます。 それ以外の場合は、 HRESULT エラー コードが返されます。

注釈

校正が必要な特定の外部デバイスでは、この方法を使用します。たとえば、テープの巻き戻しやカウンターのリセット、タイムコード リーダーのフレーム オフセットの計算などです。

さまざまな外部デバイスのフィルターは、デバイスが必要とする調整に応じて、この方法を異なる方法で実装できます。 このメソッドは、 IMediaEventSink インターフェイスが既にイベント シンクを確立しているか、別のイベント シグナリング メソッドが確立されていることを前提としています。

DV の実装

MSDV ドライバーと UVC ドライバーでは、このメソッドはサポートされていません。 メソッドはE_NOTIMPLを返します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	strmif.h (Dshow.h を含む)
Library	Strmiids.lib

こちらもご覧ください

エラーコードと成功コード

IAMExtDevice インターフェイス