ICaptureGraphBuilder2::CopyCaptureFile メソッド (strmif.h)

  • [アーティクル]

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

メソッドは CopyCaptureFile 、キャプチャ ファイルから有効なメディア データをコピーします。

構文

HRESULT CopyCaptureFile(
  [in] LPOLESTR                   lpwstrOld,
  [in] LPOLESTR                   lpwstrNew,
  [in] int                        fAllowEscAbort,
  [in] IAMCopyCaptureFileProgress *pCallback
);

パラメーター

[in] lpwstrOld

ソース ファイル名を含むワイド文字列へのポインター。

[in] lpwstrNew

コピー先のファイル名を含むワイド文字列へのポインター。 有効なデータがこのファイルにコピーされます。

[in] fAllowEscAbort

Esc キーを押すとコピー操作が取り消されるかどうかを示すブール値。 値が TRUE で 、ユーザーが Esc キーを押すと、操作は停止します。 値が FALSE の場合、メソッドは ESC キーを無視します。

[in] pCallback

進行状況情報を表示するための IAMCopyCaptureFileProgress インターフェイスへのポインター( NULL)。 詳細については、「解説」を参照してください。

戻り値

HRESULT 値を返します。 使用可能な値は次のとおりです。

リターン コード 説明
S_FALSE
 ユーザーは、完了する前に操作を取り消しました。
S_OK
 成功しました。
E_FAIL
 失敗しました。
E_INVALIDARG
 ソース ファイルまたはコピー先ファイルを開けませんでした。
E_OUTOFMEMORY
 メモリ不足です。
E_POINTER
 NULL ポインター引数。

解説

通常は、最初に大きな事前割り当て済みファイルにキャプチャします。 このメソッドは、有効なデータのみを新しいファイルにコピーします。 その結果、新しいファイルは元のファイルよりもはるかに小さくなります。

ソース ファイルとコピー先ファイルは AVI ファイルである必要があります。 その他のファイルの種類はサポートされていません。

コピー操作の進行状況を表示するには、 IAMCopyCaptureFileProgress インターフェイスを実装し、 pCallback パラメーターで インターフェイスへのポインターを渡します。 pCallback が NULL 以外の場合、このメソッドは IAMCopyCaptureFileProgress::P rogress メソッドを定期的に呼び出し、0 ~ 100 の整数で完了率を指定します。

要件

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

関連項目

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

ICaptureGraphBuilder2 インターフェイス