Interfaccia IEncoderAPI (strmif.h)

[La funzionalità associata a questa pagina, Microsoft TV Technologies, è una funzionalità legacy. Microsoft consiglia vivamente che il nuovo codice non usi questa funzionalità.

[IEncoderAPI non è più disponibile per l'uso. Usare invece ICodecAPI.]

L'interfaccia IEncoderAPI definisce un modo standard per le applicazioni e i driver di comunicare con hardware o codificatori software di terze parti che implementano l'interfaccia. Per altre informazioni su questa interfaccia, vedere API codificatore.

Ereditarietà

L'interfaccia IEncoderAPI eredita dall'interfaccia IUnknown . IEncoderAPI include anche questi tipi di membri:

• Metodi

Metodi

L'interfaccia IEncoderAPI include questi metodi.

IEncoderAPI::GetDefaultValue Il metodo GetDefaultValue recupera il valore predefinito per un parametro, se presente.
IEncoderAPI::GetParameterRange Il metodo GetParameterRange recupera l'intervallo valido di valori supportati dal parametro, nei casi in cui il parametro supporta un intervallo di spostamento anziché un elenco di valori specifici.
IEncoderAPI::GetParameterValues Il metodo GetParameterValues recupera l'elenco di valori supportati dal parametro specificato.
IEncoderAPI::GetValue Il metodo GetValue recupera il valore corrente di un parametro specificato.
IEncoderAPI::IsAvailable IEncoderAPI non è più disponibile per l'uso. (IEncoderAPI.IsAvailable)
IEncoderAPI::IsSupported Il metodo IsSupported esegue una query sul fatto che un parametro specificato sia supportato.
IEncoderAPI::SetValue Il metodo SetValue imposta il valore corrente di un parametro.

Commenti

Nei vari metodi di interfaccia, i GUID seguenti, definiti in uuids.h, vengono usati per indicare quale parametro viene impostato o recuperato.

Parametro	Descrizione
ENCAPIPARAM_BITRATE	Specifica la frequenza di bit, in bit al secondo. In modalità CBR (Constant Bit Rate), il valore fornisce la velocità in bit costante. In entrambe le modalità di velocità a bit variabile, fornisce la velocità media di bit. Il valore è un long senza segno a 32 bit.
ENCAPIPARAM_PEAK_BITRATE	Specifica la frequenza di bit di picco. Questo parametro è rilevante solo quando ENCAPIPARAM_BITRATE_MODE è stato impostato su VariableBitRatePeak.
ENCAPIPARAM_BITRATE_MODE	Specifica la modalità di frequenza dei bit, come valore di enumerazione VIDEOENCODER_BITRATE_MODE (long con segno a 32 bit).

�

Nella tabella seguente viene descritto il comportamento previsto di un codificatore in condizioni di velocità a bit estremamente elevata o bassa nelle due modalità di velocità a bit variabile definite in VIDEOENCODER_BITRATE_MODE.

Condizione	Mode	Comportamento
La scena cade in nero o c'è zero movimento	VariableBitRateAverage	In un breve periodo di tempo (diversi secondi) la frequenza di bit scenderà al di sotto della frequenza specificata per il parametro ENCAPIPARAM_BITRATE. Tuttavia, oltre un periodo di quattro minuti di tempo, il codificatore manterrà la frequenza media, se necessario aggiungendo bit "fittizi" al flusso.
La scena cade in nero o c'è zero movimento.	VariableBitRatePeak	La velocità di bit scenderà al di sotto della frequenza prevista, come specificato nel valore per il parametro ENCAPIPARAM_BITRATE. La frequenza rimarrà a quel livello fino a quando non inizia una scena più complicata.
La scena è estremamente complessa.	VariableBitRateAverage	Per alcuni secondi la frequenza verrà alzata. Se la scena rimane complessa, la frequenza tornerà indietro e l'immagine diventerà bloccata per mantenere la media come specificato nel valore per il parametro ENCAPIPARAM_BITRATE.
La scena è estremamente complessa.	VariableBitRatePeak	La frequenza verrà alzata e rimarrà aggiornata, eventualmente superiore alla frequenza prevista come specificato nel valore per il parametro ENCAPIPARAM_BITRATE, ma mai superiore al picco specificato nel parametro ENCAPIPARAM_PEAK_BITRATE.

�

Dispositivi OCUR

Questa interfaccia supporta i dispositivi OpenCable Unidirectional Cable Receiver (OCUR). Vedere Dispositivi OCUR.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)

Vedi anche

API codificatore