Share via

Método IMFDeviceTransform::GetInputStreamPreferredState (mftransform.h)

  • Artigo

O método GetInputStreamPreferredState obtém o estado preferencial e o tipo de mídia de um fluxo de entrada MFT do dispositivo.

Sintaxe

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

Parâmetros

[in] dwStreamID

ID de fluxo do fluxo de entrada cujo estado precisa ser recuperado.

[out] value

Especifica o DeviceStreamState atual do fluxo MFT do dispositivo de entrada especificado.

[out] ppMediaType

O tipo de mídia preferencial para o fluxo de entrada é passado por meio desse parâmetro.

Valor retornado

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam aos valores fornecidos na tabela a seguir.

Código de retorno Descrição
S_OK
 A transição do estado do fluxo foi bem-sucedida.
MF_E_INVALIDREQUEST
 O dispositivo MFT não pôde dar suporte à solicitação no momento.
MF_E_INVAILIDSTREAMNUMBER
 Uma ID de fluxo inválida foi passada.
MF_E_INVALID_STREAM_STATE
 A transição de fluxo solicitada não é possível.

Comentários

Essa função de interface ajuda a consultar o estado preferencial do fluxo de entrada MFT do dispositivo e o tipo de mídia para o qual ele precisa ser transferido.

Quando uma alteração no tipo de mídia do fluxo de saída precisa de alteração correspondente na entrada, o Device MFT postaria METransformInputStreamStateChanged no DTM para alterar o fluxo de entrada relevante. O DTM chamaria GetInputStreamPreferredState para recuperar o mediatype e o estado preferidos do fluxo de entrada MFT do dispositivo.

Por exemplo, considere um dispositivo MFT que tenha dois fluxos de entrada e três fluxos de saída. Deixe a saída 1 e a saída 2 da origem da Entrada 1 e transmita a 720p. Agora, digamos que o tipo de mídia da Saída 2 mude para 1080p. Para atender a essa solicitação, o Dispositivo MFT deve alterar o tipo de mídia Entrada 1 para 1080p, postando o evento METransformInputStreamStateChanged no DTM. O DTM chamaria GetInputStreamPreferredState e recuperaria o estado e o mediatype preferenciais. O DTM chamaria SetInputStreamState para alterar o estado e o tipo de mídia do fluxo de entrada.

Requisitos

   
Cliente mínimo com suporte Windows 10, versão 1703
Plataforma de Destino Windows
Cabeçalho mftransform.h

Confira também

IMFDeviceTransform