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.
| Constante | Descrição |
|---|---|
| ED_MODE_PLAY_SLOW_FWD_X | Reproduza a lentidão não especificada. (Jogo de avanço lento em velocidade específica do fornecedor.) |
| ED_MODE_PLAY_FAST_FWD_X | Reproduza um avanço rápido não especificado. (Jogo de avanço rápido em velocidade específica do fornecedor.) |
| ED_MODE_PLAY_SLOW_REV_X | Reproduza inverso lento não especificado. (Reprodução reversa lenta em velocidade específica do fornecedor.) |
| ED_MODE_PLAY_FAST_REV_X | Reproduza inverso rápido não especificado. (Jogo rápido e reverso em velocidade específica do fornecedor.) |
| ED_MODE_STOP_START | O transporte é interrompido no início da fita (ou outro meio de transporte). |
| ED_MODE_STOP_END | O transporte é interrompido no final da fita (ou outro meio de transporte). |
| ED_MODE_STOP_EMERGENCY | O transporte parou devido a condições inesperadas ou para evitar possíveis danos ao transporte. |
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.
| Constante | Descrição |
|---|---|
| ED_MEDIA_NEO | Mini fita digital para o fluxo de transporte MPEG-2 (D-VHS). |
Alguns desses sinalizadores são definidos no arquivo de cabeçalho Xptrdefs.h.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |