次の方法で共有

IWMDMProgress3::End3 メソッド (mswmdm.h)

  • [アーティクル]

End3 メソッドは、操作が完了したことを示すために Windows Media デバイス マネージャーによって呼び出されます。 このメソッドは、イベントの識別 (ID) とコマンドのコンテキストへのポインターに対して追加の入力パラメーターを指定することで 、IWMDMProgress2::End2 を拡張します。

構文

HRESULT End3(
  [in]      GUID          EventId,
  [in]      HRESULT       hrCompletionCode,
  [in, out] OPAQUECOMMAND *pContext
);

パラメーター

[in] EventId

終了するイベントを指定する GUID 。 次の表に、使用可能な値を示します。

Event 説明
SCP_EVENTID_ACQSECURECLOCK Windows Media デバイス マネージャーは、サーバーからセキュリティで保護されたクロックを取得しています。
SCP_EVENTID_NEEDTOINDIV デバイスが個別化されています。 これは現在使用されていません。
SCP_EVENTID_DRMINFO このイベント ID は、各ファイルのコンテンツにあるバージョン DRM ヘッダーを使用してアプリケーションに通知するために使用されます。

返される OPAQUECOMMAND 構造体には 、guidCommand メンバーが SCP_PARAMID_DRMVERSION に設定されています。

さらに、データは次のいずれかのフラグを指定します。

WMDM_SCP_DRMINFO_NOT_DRMPROTECTED

WMDM_SCP_DRMINFO_V1HEADER

WMDM_SCP_DRMINFO_V2HEADER
EVENT_WMDM_CONTENT_TRANSFER コンテンツはデバイス間で転送中です。

[in] hrCompletionCode

進行中の操作の完了コードを指定する HRESULT。 hrCompletionCode パラメーターは、終了した操作の戻りコードです。 このパラメーターには、標準の COM エラー コード、HRESULT に変換された Win32 エラー コード、Windows Media デバイス マネージャーエラー コードなど、任意の HRESULT を指定できます。

[in, out] pContext

Windows Media デバイス マネージャーによって処理されずにデバイスに直接送信されるコマンドを含む OPAQUECOMMAND 構造体へのポインター。 このパラメーターは省略可能であり、 NULL にすることができます。 コンテキスト構造は、コンポーネントがイベントを含む関連データをアプリケーションに送信する方法です。 この構造体を送信するコンポーネントは、アプリケーションがこのデータ構造を解釈する方法を定義する必要があります。

戻り値

Windows Media デバイス マネージャーは、このメソッドが呼び出される前に現在の操作が完了または取り消されるため、End3 メソッドによって返された戻りコードを無視します。

注釈

メソッドによって定義された操作が完了すると、操作を実装しているメソッドを所有するインターフェイスが End3 を呼び出します。

例

次の C++ コードは、 End3 の実装例を示しています。


HRESULT End3(GUID  EventId, HRESULT  hrCompletionCode, OPAQUECOMMAND*  pContext)
{
    // TODO: Display the message "IWMDMProgress3::End3 called."
    return S_OK;
}

要件

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

こちらもご覧ください

通知の有効化

IWMDMProgress3 インターフェイス

IWMDMProgress::End