IWMDMOperation::BeginWrite メソッド (mswmdm.h)

BeginWrite メソッドは、"デバイスへの書き込み" アクションが開始されていることを示します。 Windows Media デバイス マネージャーは、アプリケーションが IWMDMStorageControl/2/3::Insert/2/3 を呼び出し、このインターフェイスを渡す場合にのみ、このメソッドを呼び出します。

構文

HRESULT BeginWrite();

戻り値

アプリケーションは、次のいずれかの HRESULT 値を返す必要があります。

リターン コード	説明
S_OK	読み取り操作を続行する必要があります。
WMDM_E_USER_CANCELLED	読み取り操作は、完了せずに取り消す必要があります。
E_FAIL	指定されていないエラーが発生しました。読み取り操作は完了せずに取り消す必要があります。

注釈

このメソッドは、Windows Media デバイス マネージャーが IWMDMOperation::TransferObjectData を呼び出してデバイスへのデータの書き込みを開始する直前に呼び出されます。

例

次の C++ コード例では、 BeginWrite メソッドを実装し、デバイスへの書き込みアクションが開始されたときにメッセージを出力します。

HRESULT BeginWrite()
{
    // TODO: Display the message: "IWMDMOperation event--BeginWrite."
    
    // If the global handle of the destination file is uninitialized, fail.
    if (m_File == INVALID_HANDLE_VALUE)
        return E_FAIL;

    // Global status to let TransferObjectData know what kind of
    // operation is happening.
    m_OperationStatus = OPERATION_WRITE;
    return S_OK;
}

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	mswmdm.h
Library	Mssachlp.lib

こちらもご覧ください

ファイル転送を手動で処理する

IWMDMOperation インターフェイス

IWMDMOperation::BeginRead