Metodo IMFDeviceTransform::GetInputStreamPreferredState (mftransform.h)

Articolo
08/24/2023

Il metodo GetInputStreamPreferredState ottiene lo stato preferito e il tipo di supporto del flusso di input MFT del dispositivo.

Sintassi

HRESULT GetInputStreamPreferredState(
  [in]  DWORD             dwStreamID,
  [out] DeviceStreamState *value,
  [out] IMFMediaType      **ppMediaType
);

Parametri

[in] dwStreamID

ID flusso del flusso di input il cui stato deve essere recuperato.

[out] value

Specifica l'oggetto DeviceStreamState corrente del flusso MFT del dispositivo di input specificato.

[out] ppMediaType

Il tipo di supporto preferito per il flusso di input viene passato tramite questo parametro.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, a titolo esemplificativo, i valori specificati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Transizione dello stato del flusso completata.
MF_E_INVALIDREQUEST	Il dispositivo MFT non è riuscito a supportare la richiesta in questo momento.
MF_E_INVAILIDSTREAMNUMBER	È stato passato un ID flusso non valido.
MF_E_INVALID_STREAM_STATE	La transizione del flusso richiesta non è possibile.

Commenti

Questa funzione di interfaccia consente di eseguire una query sullo stato preferito e sul tipo di supporto del flusso di input MFT del dispositivo a cui deve essere eseguita la transizione.

Quando una modifica nel tipo di supporto del flusso di output richiede una modifica corrispondente nell'input, device MFT posterà METransformInputStreamStateChanged su DTM per modificare il flusso di input pertinente. DTM chiamerebbe GetInputStreamPreferredState per recuperare lo stato e il tipo di media preferito del flusso di input MFT del dispositivo.

Si consideri ad esempio un oggetto Device MFT con due flussi di input e tre flussi di output. Consentire l'output 1 e l'output 2 di origine dall'input 1 e dal flusso a 720p. Si supponga ora che il tipo di supporto di Output 2 cambi a 1080p. Per soddisfare questa richiesta, Device MFT deve modificare il tipo di supporto Input 1 impostandolo su 1080p, pubblicando l'evento METransformInputStreamStateChanged nel DTM. DTM chiamerà GetInputStreamPreferredState e recupererà lo stato preferito e il tipo di media. DTM chiamerà SetInputStreamState per modificare il tipo di media e lo stato del flusso di input.

Requisiti


Client minimo supportato	Windows 10 versione 1703
Piattaforma di destinazione	Windows
Intestazione	mftransform.h

Vedi anche

IMFDeviceTransform

Condividi tramite