IEncoderAPI-Schnittstelle (strmif.h)
[Das feature, das dieser Seite zugeordnet ist, Microsoft TV Technologies, ist ein Legacyfeature. Microsoft empfiehlt dringend, dass neuer Code dieses Feature nicht verwendet.]
[IEncoderAPI ist nicht mehr zur Verwendung verfügbar. Verwenden Sie stattdessen ICodecAPI.]
Die IEncoderAPI-Schnittstelle definiert eine Standardmethode für Anwendungen und Treiber zur Kommunikation mit Hardware- oder Softwareencodern von Drittanbietern, die die Schnittstelle implementieren. Weitere Informationen zu dieser Schnittstelle finden Sie unter Encoder-API.
Vererbung
Die IEncoderAPI-Schnittstelle erbt von der IUnknown-Schnittstelle . IEncoderAPI verfügt auch über folgende Membertypen:
- Methoden
Methoden
Die IEncoderAPI-Schnittstelle verfügt über diese Methoden.
| IEncoderAPI::GetDefaultValue Die GetDefaultValue-Methode ruft den Standardwert für einen Parameter ab, sofern vorhanden. |
| IEncoderAPI::GetParameterRange Die GetParameterRange-Methode ruft den gültigen Wertebereich ab, den der Parameter unterstützt, wenn der Parameter einen abgestuften Bereich im Gegensatz zu einer Liste bestimmter Werte unterstützt. |
| IEncoderAPI::GetParameterValues Die GetParameterValues-Methode ruft die Liste der Werte ab, die vom angegebenen Parameter unterstützt werden. |
| IEncoderAPI::GetValue Die GetValue-Methode ruft den aktuellen Wert eines angegebenen Parameters ab. |
| IEncoderAPI::IsAvailable IEncoderAPI ist nicht mehr zur Verwendung verfügbar. (IEncoderAPI.IsAvailable) |
| IEncoderAPI::IsSupported Die IsSupported-Methode fragt ab, ob ein bestimmter Parameter unterstützt wird. |
| IEncoderAPI::SetValue Die SetValue-Methode legt den aktuellen Wert eines Parameters fest. |
Hinweise
In den verschiedenen Schnittstellenmethoden werden die folgenden GUIDs verwendet, die in uuids.h definiert sind, um anzugeben, welcher Parameter festgelegt oder abgerufen wird.
| Parameter | BESCHREIBUNG |
|---|---|
| ENCAPIPARAM_BITRATE | Gibt die Bitrate in Bits pro Sekunde an. Im CBR-Modus (Constant Bit Rate) gibt der Wert die konstante Bitrate an. In beiden Modi mit variabler Bitrate wird die durchschnittliche Bitrate angezeigt. Der Wert ist eine 32-Bit-Länge ohne Vorzeichen. |
| ENCAPIPARAM_PEAK_BITRATE | Gibt die Spitzenbitrate an. Dieser Parameter ist nur relevant, wenn ENCAPIPARAM_BITRATE_MODE auf VariableBitRatePeak festgelegt wurde. |
| ENCAPIPARAM_BITRATE_MODE | Gibt den Bitratenmodus als VIDEOENCODER_BITRATE_MODE Enumerationswert (32-Bit-Länge) an. |
In der folgenden Tabelle wird das erwartete Verhalten eines Encoders unter bedingungen mit extrem hoher oder niedriger Bitrate in den beiden modi der variablen Bitrate beschrieben, die in VIDEOENCODER_BITRATE_MODE definiert sind.
| Bedingung | Mode | Verhalten |
|---|---|---|
| Die Szene fällt in schwarz, oder es gibt keine Bewegung | VariableBitRateAverage | Über einen kurzen Zeitraum (mehrere Sekunden) fällt die Bitrate unter die für den parameter ENCAPIPARAM_BITRATE angegebene Rate. Aber über einen Zeitraum von vier Minuten behält der Encoder die durchschnittliche Rate bei, falls erforderlich, indem er dem Stream "Dummy"-Bits hinzufügt. |
| Die Szene fällt auf schwarz, oder es gibt keine Bewegung. | VariableBitRatePeak | Die Bitrate fällt unter die erwartete Rate, wie im Wert für den parameter ENCAPIPARAM_BITRATE angegeben. Die Rate bleibt auf diesem Niveau, bis eine kompliziertere Szene beginnt. |
| Die Szene ist extrem komplex. | VariableBitRateAverage | Für einige Sekunden wird die Rate steigen. Wenn die Szene komplex bleibt, wird die Rate wieder heruntergefahren, und das Bild wird blockig, um den Durchschnitt beizubehalten, der im Wert für den parameter ENCAPIPARAM_BITRATE angegeben ist. |
| Die Szene ist extrem komplex. | VariableBitRatePeak | Die Rate geht nach oben und bleibt oben, möglicherweise über der erwarteten Rate, wie im Wert für den parameter ENCAPIPARAM_BITRATE angegeben, aber niemals über dem im parameter ENCAPIPARAM_PEAK_BITRATE angegebenen Spitzenwert. |
OCUR-Geräte
Diese Schnittstelle unterstützt OpenCable Unidirectional Cable Receiver (OCUR)-Geräte. Weitere Informationen finden Sie unter OCUR-Geräte.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |