Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[La funzionalità associata a questa pagina, Microsoft TECNOLOGIE TV, è 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 codificatori hardware o software di terze parti che implementano l'interfaccia . Per altre informazioni su questa interfaccia, vedere API del codificatore.
Inheritance
L'interfaccia IEncoderAPI eredita dall'interfaccia IUnknown . IEncoderAPI include anche questi tipi di membri:
- Methods
Methods
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 con rientri 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 se è supportato un parametro specificato. |
|
IEncoderAPI::SetValue Il metodo SetValue imposta il valore corrente di un parametro. |
Osservazioni:
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 velocità in bit, espressa in bit al secondo. In modalità CBR (Constant Bit Rate), il valore fornisce la velocità in bit costante. In entrambe le modalità di velocità in bit variabile, fornisce la velocità media dei bit. Il valore è un long senza segno a 32 bit. |
| ENCAPIPARAM_PEAK_BITRATE | Specifica la velocità di bit massima. Questo parametro è rilevante solo quando ENCAPIPARAM_BITRATE_MODE è stato impostato su VariableBitRatePeak. |
| ENCAPIPARAM_BITRATE_MODE | Specifica la modalità bit rate, 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à in bit estremamente elevata o bassa nelle due modalità a velocità in bit variabile definite in VIDEOENCODER_BITRATE_MODE.
| Condizione | Modo | Comportamento |
|---|---|---|
| La scena cade in nero o c'è zero movimento | VariableBitRateAverage | In un breve periodo di tempo (diversi secondi) la velocità di bit scenderà al di sotto della frequenza specificata per il parametro ENCAPIPARAM_BITRATE. Tuttavia, in un periodo di quattro minuti, 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à in bit scenderà al di sotto della frequenza prevista come specificato nel valore per il parametro ENCAPIPARAM_BITRATE. La frequenza rimarrà a quel livello fino all'inizio di una scena più complicata. |
| La scena è estremamente complessa. | VariableBitRateAverage | Per alcuni secondi la frequenza andrà in alto. 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 | Il tasso continuerà a salire e rimanere al di sopra della frequenza prevista come specificato nel valore per il parametro ENCAPIPARAM_BITRATE, ma non oltre il picco specificato nel parametro ENCAPIPARAM_PEAK_BITRATE. |
Dispositivi OCUR
Questa interfaccia supporta i dispositivi OpenCable Unidirectional Cable Receiver (OCUR). Vedere Dispositivi OCUR.
Requisiti
| Requisito | Value |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |