Método IAMExtTransport::GetCapability (strmif.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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 GetCapability método recupera os recursos gerais do transporte.
Sintaxe
HRESULT GetCapability(
[in] long Capability,
[out] long *pValue,
[out] double *pdblValue
);
Parâmetros
[in] Capability
Especifica a capacidade de marcar. Confira Comentários para obter mais informações.
[out] pValue
Ponteiro para uma variável que recebe um inteiro longo . Confira Comentários para obter mais informações.
[out] pdblValue
Ponteiro para uma variável que recebe um duplo. Confira Comentários para obter mais informações.
Retornar valor
Quando esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .
Comentários
O parâmetro Capability é um sinalizador que especifica qual funcionalidade marcar. O método retorna o resultado no parâmetro pValue ou no parâmetro pdblValue , dependendo do sinalizador de funcionalidade.
Para os sinalizadores a seguir, o método retorna o valor OATRUE ou OAFALSE no parâmetro pValue . O valor OATRUE indica que a funcionalidade está presente, enquanto o valor OAFALSE indica que ele está ausente.
| Sinalizador de funcionalidade | Descrição |
|---|---|
| ED_TRANSCAP_CAN_ASSEMBLE | O transporte pode usar o modo de registro de montagem (registrar novas faixas que se vinculam perfeitamente à faixa de controle do segmento registrado anteriormente). |
| ED_TRANSCAP_CAN_BUMP_PLAY | O transporte pode ser sincronizado por velocidade variável. |
| ED_TRANSCAP_CAN_DELAY_AUDIO_IN | O transporte pode executar edições de áudio atrasadas. |
| ED_TRANSCAP_CAN_DELAY_AUDIO_OUT | O transporte pode executar edições de áudio atrasadas. |
| ED_TRANSCAP_CAN_DELAY_VIDEO_IN | O transporte pode executar edições de vídeo atrasadas. |
| ED_TRANSCAP_CAN_DELAY_VIDEO_OUT | O transporte pode executar edições de vídeo atrasadas. |
| ED_TRANSCAP_CAN_DETECT_LENGTH | O transporte pode detectar o comprimento da mídia. |
| ED_TRANSCAP_CAN_EJECT | O transporte pode ejetar a mídia. |
| ED_TRANSCAP_CAN_FREEZE | O transporte pode congelar/pausar. |
| ED_TRANSCAP_CAN_INSERT | O transporte pode usar o modo de registro de inserção (registrar faixas individuais enquanto estiver bloqueado em uma faixa de controle pré-registrada). |
| ED_TRANSCAP_CAN_PLAY_BACKWARDS | O transporte pode ser reproduzido para trás. |
| ED_TRANSCAP_CAN_SET_EE | O transporte pode mostrar a entrada do dispositivo em sua saída. |
| ED_TRANSCAP_CAN_SET_PB | O transporte pode mostrar a reprodução de mídia em sua saída. |
| ED_TRANSCAP_FIELD_STEP | O transporte responde a um comando de avanço de quadro avançando um campo. |
| ED_TRANSCAP_HAS_CLOCK | O dispositivo tem um relógio. |
| ED_TRANSCAP_HAS_DT | O dispositivo tem acompanhamento dinâmico. |
| ED_TRANSCAP_HAS_TIMER | O dispositivo tem um temporizador. |
| ED_TRANSCAP_HAS_TUNER | O dispositivo tem um sintonizador. |
| ED_TRANSCAP_IS_MASTER | O dispositivo é o relógio master para sincronização. |
| ED_TRANSCAP_MULTIPLE_EDITS | O dispositivo dá suporte a vários eventos de edição. |
| ED_TRANSCAP_NEEDS_CUEING | O dispositivo deve ser identificado antes de executar uma edição. |
| ED_TRANSCAP_NEEDS_TBC | O dispositivo precisa ser calibrado. |
Para os sinalizadores a seguir, o método retorna um valor numérico no parâmetro pValue .
| Sinalizador de funcionalidade | Valor retornado |
| ED_TRANSCAP_LTC_TRACK | Retorna o número da faixa de código de tempo LTC ou ED_ALL se não houver uma faixa de código de tempo dedicada. |
| ED_TRANSCAP_NUM_AUDIO_TRACKS | Retorna o número de faixas de áudio. |
Para os sinalizadores a seguir, o método retorna um valor no parâmetro pdblValue .
| Sinalizador de funcionalidade | Valor retornado |
| ED_TRANSCAP_FWD_SHUTTLE_MAX | Velocidade máxima de avanço no modo de transporte, como uma velocidade múltipla de jogo. |
| ED_TRANSCAP_FWD_SHUTTLE_MIN | Velocidade mínima de avanço no modo de transporte, como uma velocidade múltipla de jogo. |
| ED_TRANSCAP_FWD_VARIABLE_MAX | Velocidade máxima para a frente, como uma velocidade de várias jogadas. |
| ED_TRANSCAP_FWD_VARIABLE_MIN | Velocidade mínima para a frente, como uma velocidade múltipla de jogo. |
| ED_TRANSCAP_REV_SHUTTLE_MAX | Velocidade inversa máxima no modo de transporte, como uma velocidade de várias jogadas. |
| ED_TRANSCAP_REV_SHUTTLE_MIN | Velocidade inversa mínima no modo de transporte, como uma velocidade múltipla de jogo. |
| ED_TRANSCAP_REV_VARIABLE_MAX | Velocidade inversa máxima, como uma velocidade múltipla de jogo. |
| ED_TRANSCAP_REV_VARIABLE_MIN | Velocidade inversa mínima, como uma velocidade de várias jogadas. |
Implementação de DV
O MSDV não dá suporte a esse método. Ele retorna E_NOTIMPL.
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 |