IWMDMObjectInfo::GetPlayLength メソッド (mswmdm.h)

GetPlayLength メソッドは、形式に適した単位でオブジェクトの再生長を取得します。これは、ファイルが再生できる残りの長さであり、その全長ではありません。

構文

HRESULT GetPlayLength(
  [out] DWORD *pdwLength
);

[out] pdwLength

ファイルの残りの再生長をミリ秒単位で指定する DWORD へのポインター。

このメソッドは HRESULT を返します。 Windows Media デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

取得される再生長の値は、オブジェクトの全長から現在の再生位置を引いた値 ( SetPlayLength メソッドが呼び出されていない場合)、または SetPlayLength によって設定された値が、オブジェクトの再生長の合計から現在の再生位置を引いた長さ以下に切り取られます。

再生の長さの情報は、ユーザーがメディアデバイスでファイルの再生を開始したとき、またはアプリケーションが Play メソッドを呼び出すときに変更される可能性があります。

再生可能なファイルを含むフォルダーまたはファイルシステムの場合、返される値は、そのフォルダー内のトラックまたは再生可能なファイルの数、またはそのファイルシステムのルートにあります。