Método IAMExtTransport::GetStatus (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O GetStatus método retorna informações sobre o status do transporte.

Sintaxe

HRESULT GetStatus(
  [in]      long StatusItem,
  [in, out] long *pValue
);

Parâmetros

[in] StatusItem

Especifica as informações de status a serem recuperadas. Confira Comentários para obter mais informações.

[in, out] pValue

Ponteiro para a variável que especifica ou recebe um inteiro longo , cujo significado depende do valor de StatusItem. Confira Comentários para obter mais informações.

Retornar valor

Quando esse método é bem-sucedido, ele retorna S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

O parâmetro StatusItem é um sinalizador que especifica quais informações status recuperar. O método retorna nas informações no parâmetro pValue . Nem todos os dispositivos dão suporte a cada sinalizador de status. Os seguintes sinalizadores são definidos:

• ED_MODE: retorna o modo de transporte atual, como pausar ou reproduzir. Consulte IAMExtTransport::p ut_Mode para obter uma lista de constantes que definem os modos de transporte. Como alternativa, você pode definir StatusItem igual a uma dessas constantes e pValue receberá o valor OATRUE se o transporte estiver atualmente nesse modo ou OAFALSE caso contrário.
• ED_MEDIA_TYPE: indica o formato da mídia para esse transporte. Retorna uma das seguintes constantes.

  Constante	Descrição
  ED_MEDIA_VHS	VHS
  ED_MEDIA_SVHS	S-VHS
  ED_MEDIA_HI8	Hi-8
  ED_MEDIA_UMATIC	Umatic
  ED_MEDIA_DVC	Fita DV (DVC)
  ED_MEDIA_1_INCH	Fita de 1 polegada
  ED_MEDIA_D1	Formato D1
  ED_MEDIA_D2	Formato D2
  ED_MEDIA_D3	Formato D3
  ED_MEDIA_D5	Formato D5
  ED_MEDIA_DBETA	Digital Betacam
  ED_MEDIA_BETA	Betacam
  ED_MEDIA_8MM	8 milímetros
  ED_MEDIA_DDR	Gravador de disco digital
  ED_MEDIA_SX	Betacam SX
  ED_MEDIA_OTHER	Outro
  ED_MEDIA_CLV	Laserdisc CLV (velocidade linear constante ou "jogo padrão")
  ED_MEDIA_CAV	CAV (velocidade de Angular constante ou laserdisc "jogo estendido")

   
• ED_LINK_MODE: retornará OATRUE se os controles do transporte estiverem vinculados aos métodos Executar, Parar e Pausar do grafo de filtro e, caso contrário, o OAFALSE. Consulte IAMExtTransport::p ut_Mode para obter mais informações.
• ED_MEDIA_PRESENT: retorna OATRUE se a mídia do transporte estiver presente ou OAFALSE caso contrário.
• ED_MEDIA_LENGTH: retorna o comprimento da mídia, em unidades do formato de hora atual (consulte IAMExtTransport::SetTransportBasicParameters).
• ED_MEDIA_TRACK_COUNT: retorna a contagem de faixas.
• ED_MEDIA_TRACK_LENGTH: retorna o comprimento da faixa, em unidades do formato de hora atual.
• ED_MEDIA_SIDE: indica qual lado da mídia está ativo.

Para usar essas constantes, inclua o arquivo de cabeçalho Xprtdefs.h do SDK do Windows.

Implementação de DV

O MSDV dá suporte aos seguintes sinalizadores de status:

• ED_MODE: consulte os comentários anteriores.
• ED_MEDIA_TYPE: retorna um dos seguintes valores.

  Constante	Descrição
  ED_MEDIA_VHS	Fita VHS.
  ED_MEDIA_DVC	Fita DV.
  ED_MEDIA_UNKNOWN	Tipo desconhecido.
  ED_MEDIA_NOT_PRESENT	O transporte está vazio.

   
• ED_DEV_REMOVED_HEVENT_GET. Retorna um identificador para um evento. O driver sinaliza o evento se o dispositivo for fisicamente removido do sistema.
• ED_DEV_REMOVED_HEVENT_RELEASE. Libera o identificador de evento obtido por meio do sinalizador ED_DEV_REMOVED_HEVENT_GET. Especifique o endereço do identificador no parâmetro pValue.
• ED_MODE_CHANGE_NOTIFY. Retorna o estado do dispositivo em pValue. Se o método retornar E_PENDING, uma alteração de estado estará pendente. Você pode usar o sinalizador ED_NOTIFY_HEVENT_GET para receber notificação quando a alteração de estado for concluída.
• ED_NOTIFY_HEVENT_GET. Retorna um identificador para um evento. O driver sinaliza o evento quando o dispositivo conclui uma alteração de modo.
• ED_NOTIFY_HEVENT_RELEASE. Libera o identificador de evento obtido por meio do sinalizador ED_NOTIFY_HEVENT_GET. Especifique o endereço do identificador no parâmetro pValue.

Implementação do camcorder MPEG

O MSTape dá suporte a um formato de mídia adicional para o sinalizador ED_MEDIA_TYPE.

Alguns desses sinalizadores são definidos no arquivo de cabeçalho Xptrdefs.h.

Requisitos

Confira também

Códigos de erro e êxito

IAMExtTransport Interface