Metodo IEncoderAPI::GetParameterRange (strmif.h)

Articolo
03/02/2024

[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.]

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.

Sintassi

HRESULT GetParameterRange(
  [in]  const GUID *Api,
  [out] VARIANT    *ValueMin,
  [out] VARIANT    *ValueMax,
  [out] VARIANT    *SteppingDelta
);

Parametri

[in] Api

Puntatore a un GUID che specifica il parametro.

[out] ValueMin

Puntatore a un tipo VARIANT che riceve il valore minimo del parametro.

[out] ValueMax

Puntatore a un tipo VARIANT che riceve il valore massimo del parametro.

[out] SteppingDelta

Puntatore a un tipo VARIANT che riceve il delta di passaggio, che definisce gli incrementi validi da ValueMin a ValueMax.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_NOTIMPL	La proprietà supporta un elenco di valori possibili, non un intervallo lineare.

Commenti

L'intervallo valido per il parametro è [ValueMax... ValueMax], con incrementi di SteppingDelta. Se un parametro supporta un intervallo di valori con spostamento, deve usare uno dei tipi varianti seguenti:

Tipi senza segno : VT_UI8, VT_UI4, VT_UI2, VT_UI1
Tipi firmati : VT_I8, VT_I4, VT_I2
Tipi float : VT_R8, VT_R4

Per definizione, il parametro restituirà un tipo specifico.

Qualsiasi valore di passaggio è valido. Se l'intervallo non ha un differenziale di passaggio, ovvero è possibile aumentare in base a qualsiasi valore, il codificatore deve restituire un valore vuoto (VT_EMPTY) per SteppingDelta.

Se Api è uguale a ENCAPIPARAM_BITRATE_MODE, il metodo restituisce E_NOTIMPL, perché le costanti in modalità bit sono un elenco di valori specifici.

Requisiti

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

Vedi anche

API codificatore

Interfaccia IEncoderAPI

Condividi tramite