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

BeginRead メソッドは、"デバイスからの読み取り" アクションが開始されていることを示します。 Windows Media デバイス マネージャーは、アプリケーションが IWMDMStorageControl::Read を呼び出し、この IWMDMOperation インターフェイスを渡す場合にのみ、このメソッドを呼び出します。

構文

HRESULT BeginRead();

戻り値

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

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

注釈

このメソッドは、Windows Media デバイス マネージャーが IWMDMOperation::TransferObjectData を呼び出す直前に呼び出されます。

例

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

HRESULT BeginRead()
{
    // TODO: Display the message: "IWMDMOperation event--BeginRead."

    // If the global handle of the source 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_READ;
    return S_OK;
}

要件

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

こちらもご覧ください

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

IWMDMOperation インターフェイス

IWMDMOperation::BeginWrite