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

[アーティクル]
08/25/2023

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;
}