Método IAMExtTransport::GetTransportBasicParameters (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 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.

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.

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

Requisitos

Confira também

Códigos de erro e êxito

IAMExtTransport Interface