IEncoderAPI インターフェイス (strmif.h)
[このページに関連付けられている機能である Microsoft TV Technologies は、従来の機能です。 Microsoft では、新しいコードではこの機能を使用しないことを強くお勧めします。]
[IEncoderAPI は使用できなくなりました。 代わりに、 ICodecAPI を使用します。
IEncoderAPI インターフェイスは、アプリケーションとドライバーが、インターフェイスを実装するサードパーティのハードウェアまたはソフトウェア エンコーダーと通信するための標準的な方法を定義します。 このインターフェイスの詳細については、「 Encoder API」を参照してください。
継承
IEncoderAPI インターフェイスは、IUnknown インターフェイスから継承されます。 IEncoderAPI には、次の種類のメンバーもあります。
- メソッド
メソッド
IEncoderAPI インターフェイスには、これらのメソッドがあります。
| IEncoderAPI::GetDefaultValue GetDefaultValue メソッドは、パラメーターの既定値 (存在する場合) を取得します。 |
| IEncoderAPI::GetParameterRange GetParameterRange メソッドは、パラメーターが特定の値のリストではなくステップ範囲をサポートする場合に、パラメーターがサポートする有効な値の範囲を取得します。 |
| IEncoderAPI::GetParameterValues GetParameterValues メソッドは、指定されたパラメーターでサポートされている値の一覧を取得します。 |
| IEncoderAPI::GetValue GetValue メソッドは、指定したパラメーターの現在の値を取得します。 |
| IEncoderAPI::IsAvailable IEncoderAPI は使用できなくなりました。 (IEncoderAPI.IsAvailable) |
| IEncoderAPI::IsSupported IsSupported メソッドは、指定されたパラメーターがサポートされているかどうかを照会します。 |
| IEncoderAPI::SetValue SetValue メソッドは、パラメーターの現在の値を設定します。 |
注釈
さまざまなインターフェイス メソッドでは、uuids.h で定義されている次の GUID を使用して、設定または取得されるパラメーターを示します。
| パラメーター | 説明 |
|---|---|
| ENCAPIPARAM_BITRATE | ビット レートを 1 秒あたりのビット数で指定します。 定数ビット レート (CBR) モードでは、値は一定のビットレートを提供します。 どちらの可変ビット レート モードでも、平均ビット レートが提供されます。 値は 32 ビット符号なし long です。 |
| ENCAPIPARAM_PEAK_BITRATE | ピーク ビット レートを指定します。 このパラメーターは、 ENCAPIPARAM_BITRATE_MODE が VariableBitRatePeak に設定されている場合にのみ関連します。 |
| ENCAPIPARAM_BITRATE_MODE | ビット レート モードを VIDEOENCODER_BITRATE_MODE 列挙値 (32 ビット符号付き long) として指定します。 |
次の表では、 VIDEOENCODER_BITRATE_MODEで定義されている 2 つの可変ビットレート モードで、非常に高いビットレートまたは低ビットレートの条件下でのエンコーダーの予期される動作について説明します。
| 条件 | モード | 動作 |
|---|---|---|
| シーンが黒に落ちたり、モーションがゼロになる | VariableBitRateAverage | 短い期間 (数秒) にわたって、ビット レートは ENCAPIPARAM_BITRATE パラメーターに指定されたレートを下回ります。 ただし、4 分間にわたって、エンコーダーは"ダミー" ビットをストリームに追加することで、必要に応じて平均レートを維持します。 |
| シーンが黒に落ちたり、モーションがゼロになります。 | VariableBitRatePeak | ビットレートは、ENCAPIPARAM_BITRATE パラメーターの値で指定された予想レートを下回ります。 より複雑なシーンが始まるまで、レートはそのレベルにとどまります。 |
| シーンは非常に複雑です。 | VariableBitRateAverage | 数秒間、レートが上がります。 シーンが複雑なままの場合は、ENCAPIPARAM_BITRATE パラメーターの値で指定された平均を維持するために、速度が低下し、画像がブロックされます。 |
| シーンは非常に複雑です。 | VariableBitRatePeak | レートは上がり、ENCAPIPARAM_BITRATE パラメーターの値で指定された予想レートを上回る可能性がありますが、ENCAPIPARAM_PEAK_BITRATE パラメーターで指定されたピークを超えることはありません。 |
OCUR デバイス
このインターフェイスは、OpenCable 一方向ケーブル レシーバー (OCUR) デバイスをサポートしています。 「 OCUR デバイス」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | strmif.h (Dshow.h を含む) |