IMFPMediaItem::GetUserData メソッド (mfplay.h)

大事な 廃止。この API は、Windows の今後のリリースから削除される可能性があります。アプリケーションでは、再生にメディアセッションを使用する必要があります。

メディア項目に格納されているアプリケーション定義の値を取得します。

構文

HRESULT GetUserData(
  [out] DWORD_PTR *pdwUserData
);

[out] pdwUserData

メディア項目のアプリケーション定義値を受け取ります。

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

この値は、最初にメディア項目を作成するときに、IMFPMediaPlayer::CreateMediaItemFromURL メソッドまたは IMFPMediaPlayer::CreateMediaItemFromObject メソッドの dwUserData パラメーターで指定することで割り当てることができます。値を更新するには、 IMFPMediaItem::SetUserData を呼び出します。

このメソッドは、プレーヤーオブジェクトがシャットダウンされた後に呼び出すことができます。


サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	mfplay.h