IAMStreamConfig::SetFormat メソッド (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
メソッドは SetFormat 、ピンの出力形式を設定します。
構文
HRESULT SetFormat(
[in] AM_MEDIA_TYPE *pmt
);
パラメーター
[in] pmt
新しい形式を指定する AM_MEDIA_TYPE 構造体へのポインター。
戻り値
HRESULT 値を返します。 使用可能な値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
メモリ不足です。 |
|
NULL ポインター値。 |
|
このメディアの種類は無効です。 |
|
入力ピンが接続されていません。 |
|
型を設定できません。フィルターは停止しません。 |
|
型を設定できません。フィルターは停止しません。 |
注釈
このメソッドは、出力ピンの形式を指定します。 ピンが接続されていない場合は、次の接続にこの形式が使用されます。 ピンが既に接続されている場合、この形式との再接続が試行されます。 他のピンが新しい型を拒否した場合、メソッドが失敗する可能性があります。
このメソッドが成功した場合、 IPin::EnumMediaTypes メソッドの後続の呼び出しでは新しい型が返され、それ以外の呼び出しは返されません。
ほとんどのフィルターでは、フィルターが一時停止または実行されている場合、このメソッドは失敗します。 一部の圧縮フィルターでは、フィルターの入力ピンが接続されていない場合、メソッドは失敗します。
一部のフィルターでは、このメソッドを NULL 値で呼び出して、ピンを既定の形式にリセットできます。
フィルター開発者: 次の解説では、このメソッドを実装する方法について説明します。
出力ピンが接続されておらず、ピンが指定したメディアの種類をサポートしている場合は、S_OKを返します。 メディアの種類を格納し、 CBasePin::GetMediaType メソッドで形式番号 0 として提供します。 他の形式を提供せず、 CBasePin::CheckMediaType メソッドで他の形式を拒否してください。
ピンが既に接続されていて、ピンがメディアの種類をサポートしている場合は、その種類でピンを再接続します。 もう一方のピンで新しい型が拒否された場合は、VFW_E_INVALIDMEDIATYPEを返し、元の接続を復元します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |
| Library | Strmiids.lib |