IAudioMediaType::IsEqual メソッド (audiomediatype.h)
メソッドは IsEqual
、2 つのメディアの種類を比較し、それらが同じかどうかを判断します。
構文
HRESULT IsEqual(
[in] IAudioMediaType *pIAudioType,
[out] DWORD *pdwFlags
);
パラメーター
[in] pIAudioType
比較するメディアの種類の IAudioMediaType インターフェイスへのポインターを指定します。
[out] pdwFlags
0 個以上のフラグのビットごとの OR 結果を含む DWORD 変数へのポインターを指定します。 これらのフラグは、2 つのメディアの種類間の類似性を示します。 次の表は、サポートされているフラグを示しています。
フラグ | 説明 |
---|---|
AUDIOMEDIATYPE_EQUAL_FORMAT_TYPES | オーディオ形式の種類は同じです。 |
AUDIOMEDIATYPE_EQUAL_FORMAT_DATA | 形式情報は一致し、基本 WAVEFORMATEX 構造体を超える追加データは含まれません。 |
AUDIOMEDIATYPE_EQUAL_FORMAT_USER_DATA | 余分なデータが同じであるか、メディアの種類に余分なデータが含まれていません。 |
戻り値
メソッドは IsEqual
、成功した場合はS_OKを返します。それ以外の場合は、次の表に示す HRESULT 値のいずれかを返します。
リターン コード | 説明 |
---|---|
|
1 つのメディアの種類が無効であるか、両方のメディアの種類が無効です。 |
|
メディアの種類が等しくありません。 pdwFlags パラメーターを調べて、メディアの種類がどのように異なるかを判断します。 |
注釈
どちらのメディア型もメジャー型である必要があります。それ以外の場合、メソッドはE_INVALIDARGを返します。 メディアの種類の詳細については、「 メディアの種類」を参照してください。
MF_MEDIATYPE_EQUAL_FORMAT_DATA フラグは、両方のメディアタイプが互換性のある属性を持っていることを示しますが、一方は他方のスーパーセットである可能性があります。 この比較方法は、部分的に指定されたメディアタイプを完全なメディアタイプと比較できることを意味します。 たとえば、同じ形式を記述する 2 つのビデオの種類がありますが、1 つの種類には拡張色情報 (クロマ シティング、公称範囲など) の属性が含まれている場合があります。
メソッドが成功し、すべての比較フラグが pdwFlags に設定されている場合、戻り値はS_OK。 メソッドが成功しても、一部の比較フラグが設定されていない場合、メソッドはS_FALSEを返します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows で使用できます。 |
対象プラットフォーム | デスクトップ |
Header | audiomediatype.h (Audiomediatype.h を含む) |
IRQL | すべてのレベル。 |