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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
関数が正常に実行されました。 |
解説
要求が完了すると、コールバック オブジェクトの IMFAsyncCallback::Invoke メソッドが呼び出されます。 その後、コールバック オブジェクトは MFEndCreateFile 関数を呼び出して、バイト ストリームへのポインターを取得する必要があります。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mfapi.h |
| Library | Mfplat.lib |
| [DLL] | Mfplat.dll |