Compartilhar via


Usando as classes base do DirectShow

[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.]

Para usar as classes base no DirectShow, você deve criar e vincular a biblioteca de classes base.

A biblioteca de classes base é fornecida como um exemplo de SDK no Microsoft Windows Software Development Kit (SDK) (https://go.microsoft.com/fwlink/p/?linkid=62332). O local exato depende da versão do SDK que você instalou, mas o caminho relativo é:

(Raiz de exemplos do SDK)\DirectShow\BaseClasses

Cabeçalho: Streams.h

Biblioteca: o exemplo compila versões de varejo e depuração da biblioteca:

  • Versão de varejo: Strmbase.lib
  • Versão de depuração: Strmbasd.lib.

Para obter mais informações sobre como configurar seu ambiente de build, consulte Configurando o ambiente de build.

Símbolos do pré-processador.

Quando você inclui o arquivo de cabeçalho Streams.h, os seguintes símbolos de pré-processador têm um significado especial:

  • PERF: reservado. Não use esse símbolo de pré-processador.
  • VFWROBUST: habilita a validação de ponteiro no varejo. Para obter mais informações, consulte Macros de validação de ponteiro. Em builds de depuração, não é necessário definir VFWROBUST.

Observação

No Windows Vista e posteriores, as macros de validação de ponteiro estão vazias.