Compartilhar via

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

  • Artigo

[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 GetTransportBasicParameters método recupera propriedades gerais do transporte externo.

Sintaxe

HRESULT GetTransportBasicParameters(
  [in]      long     Param,
  [in, out] long     *pValue,
  [in, out] LPOLESTR *ppszData
);

Parâmetros

[in] Param

Especifica qual propriedade receber.

[in, out] pValue

Ponteiro para uma variável que recebe um valor inteiro longo . Confira Comentários para obter mais informações.

[in, out] ppszData

Ponteiro para uma variável do tipo LPOLESTR que recebe uma cadeia de caracteres. 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 Param é um sinalizador que especifica qual propriedade recuperar. Algumas propriedades são numéricas; eles são retornados no parâmetro pValue . Outras propriedades são valores de cadeia de caracteres; eles são retornados no parâmetro ppszData . Para obter uma lista de sinalizadores e valores esperados, consulte IAMExtTransport::SetTransportBasicParameters.

Se o método retornar uma cadeia de caracteres, o chamador deverá liberar a cadeia de caracteres, usando a função CoTaskMemFree .

Implementação de camcorder DV e MPEG

O MSDV dá suporte aos seguintes sinalizadores adicionais:

  • ED_RAW_EXT_DEV_CMD: invoca um comando AV/C bruto. Especifique o comando AV/C como uma matriz de bytes no parâmetro ppszData . Especifique o tamanho do comando, em bytes, no parâmetro pValue . Quando o método retorna, ppszData contém a resposta do dispositivo e pValue contém o tamanho da resposta, em bytes. O comando AV/C é passado diretamente para o dispositivo sem validação ou verificação de erros.

    O conteúdo da resposta pode ser maior que o comando . É responsabilidade do chamador alocar espaço suficiente no buffer para a resposta. O tamanho máximo da carga é de 512 bytes.

    Para obter mais informações, consulte Emitindo comandos brutos de AV/C.

  • ED_TRANSBASIC_INPUT_SIGNAL: recupera o formato de sinal que o filmador DV foi projetado para aceitar. Retorna uma das seguintes constantes em pValue.
    Constante Descrição
    ED_TRANSBASIC_SIGNAL_525_60_SD Sinal de SD do NTSC.
    ED_TRANSBASIC_SIGNAL_525_60_SDL Sinal de SDL do NTSC (long-play).
    ED_TRANSBASIC_SIGNAL_625_50_SD Sinal SD pal.
    ED_TRANSBASIC_SIGNAL_625_50_SDL Sinal SDL pal (jogo longo).
    ED_TRANSBASIC_SIGNAL_MPEG2TS Sinal de D-VHS.
     
  • ED_TRANSBASIC_OUTPUT_SIGNAL: recupera o formato de sinal que o filmador DV foi projetado para transmitir. Retorna uma das constantes listadas para o sinalizador ED_TRANSBASIC_INPUT_SIGNAL.

O MSTape dá suporte a valores adicionais para ED_TRANSBASIC_INPUT_SIGNAL e ED_TRANSBASIC_OUTPUT_SIGNAL.

Constante Descrição
ED_TRANSBASIC_SIGNAL_2500_60_MPEG Fluxo MPEG de 25 Mbps/60.
ED_TRANSBASIC_SIGNAL_1250_60_MPEG Fluxo MPEG de 12,5 Mbps/60.
ED_TRANSBASIC_SIGNAL_0625_60_MPEG Fluxo MPEG de 6,25 Mbps/60.
ED_TRANSBASIC_SIGNAL_2500_50_MPEG Fluxo MPEG de 25 Mbps/50.
ED_TRANSBASIC_SIGNAL_1250_50_MPEG Fluxo MPEG de 12,5 Mbps/50.
ED_TRANSBASIC_SIGNAL_0625_50_MPEG Fluxo MPEG de 6,25 Mbps/50.
ED_TRANSBASIC_SIGNAL_UNKNOWN Formato de sinal desconhecido.
 

Esses sinalizadores são definidos no arquivo de cabeçalho Xprtdefs.h.

No Windows XP Service Pack 2 e posterior, os seguintes tipos de sinal adicionais são definidos para os sinalizadores ED_TRANSBASIC_INPUT_SIGNAL e ED_TRANSBASIC_OUTPUT_SIGNAL.

Constante Descrição
ED_TRANSBASIC_SIGNAL_525_60_DV25 DVCPRO 25, 525-60.
ED_TRANSBASIC_SIGNAL_625_50_DV25 DVCPRO 25, 625-50.
ED_TRANSBASIC_SIGNAL_525_60_DV50 DVCPRO 50, 525-60.
ED_TRANSBASIC_SIGNAL_625_50_DV50 DVCPRO 50, 625-50.
ED_TRANSBASIC_SIGNAL_HD_60_DVH1 DVCPRO 100, 1080i ou 720p
ED_TRANSBASIC_SIGNAL_HD_50_DVH1 Somente DVCPRO 100, 1080i
 

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

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

Confira também

Códigos de erro e êxito

IAMExtTransport Interface