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) |