Construtor CBasePin.CBasePin

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

Método de construtor.

Sintaxe

CBasePin(
   TCHAR         *pObjectName,
   CBaseFilter   *pFilter,
   CCritSec      *pLock,
   HRESULT       *phr,
   LPCWSTR       pName,
   PIN_DIRECTION dir
);

Parâmetros

pObjectName

Cadeia de caracteres que contém o nome de depuração do objeto. Para obter mais informações, consulte CBaseObject.

pFilter

Ponteiro para o filtro que criou esse pino.

Plock

Ponteiro para um bloqueio CCritSec , usado para serializar alterações de estado. Pode ser a mesma seção crítica que o bloqueio de filtro, CBaseFilter::m_pLock.

Phr

Ponteiro para uma variável que recebe um valor HRESULT que indica o êxito ou a falha do método. Inicialize o valor para S_OK antes de criar o objeto . O valor será alterado somente se ocorrer um erro.

pName

Cadeia de caracteres largos que contém o nome do pino. Para obter mais informações, consulte CBasePin::QueryPinInfo.

dir

Membro da enumeração PIN_DIRECTION especificando a direção do pino.

Comentários

A seção crítica especificada pelo pLock serializa o estado do pino, incluindo sua status de conexão, a escolha do alocador, o tipo de mídia e o status de operações de liberação. Não use esta seção crítica para serializar operações de streaming. Para obter mais informações, consulte Fluxo de Dados no Grafo de Filtro.

Um filtro pode criar pinos em seu método de construtor, portanto, neste ponto, o ponteiro pFilter pode não se referir a um objeto válido. Armazene o ponteiro, mas não desreferencia-o enquanto estiver dentro do construtor do pino.

Requisitos

Requisito	Valor
parâmetro	Amfilter.h (inclua Streams.h)
Biblioteca	Strmbase.lib (builds de varejo); Strmbasd.lib (builds de depuração)

Confira também

Classe CBasePin