MFBeginCreateFile 関数 (mfapi.h)

ファイルからバイト ストリームを作成するための非同期要求を開始します。

構文

HRESULT MFBeginCreateFile(
  [in]  MF_FILE_ACCESSMODE AccessMode,
  [in]  MF_FILE_OPENMODE   OpenMode,
  [in]  MF_FILE_FLAGS      fFlags,
  [in]  LPCWSTR            pwszFilePath,
  [in]  IMFAsyncCallback   *pCallback,
  [in]  IUnknown           *pState,
  [out] IUnknown           **ppCancelCookie
);

パラメーター

[in] AccessMode

要求されたアクセス モード。 MF_FILE_ACCESSMODE 列挙体のメンバーとして指定されます。

[in] OpenMode

ファイルが既に存在する場合、または存在しない場合の関数の動作。 MF_FILE_OPENMODE 列挙体のメンバーとして指定されます。

[in] fFlags

MF_FILE_FLAGS列挙の値のビットごとの OR。

[in] pwszFilePath

ファイル名を含む null で終わる文字列へのポインター。

[in] pCallback

コールバック オブジェクトの IMFAsyncCallback インターフェイスへのポインター。 呼び出し元は、このインターフェイスを実装する必要があります

[in] pState

呼び出し元によって定義された状態オブジェクトの IUnknown インターフェイスへのポインター。 このパラメーターは、NULL でもかまいません。 このオブジェクトを使用して、状態情報を保持できます。 コールバックが呼び出されると、オブジェクトが呼び出し元に返されます。

[out] ppCancelCookie

IUnknown ポインターまたは値 NULL を受け取ります。 値が NULL でない場合は、このポインターを MFCancelCreateFile 関数に渡すことで非同期操作を取り消すことができます。 呼び出し元はインターフェイスを解放する必要があります。 このパラメーターは省略可能であり、 NULL にすることができます。

戻り値

関数は HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード	説明
S_OK	関数が正常に実行されました。

解説

要求が完了すると、コールバック オブジェクトの IMFAsyncCallback::Invoke メソッドが呼び出されます。 その後、コールバック オブジェクトは MFEndCreateFile 関数を呼び出して、バイト ストリームへのポインターを取得する必要があります。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	mfapi.h
Library	Mfplat.lib
[DLL]	Mfplat.dll

関連項目

メディア ファンデーション機能