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 |