Método CSourceStream.QueryId

  • 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 QueryId método recupera um identificador para o pino.

Sintaxe

HRESULT QueryId(
   LPWSTR *Id
);

Parâmetros

Id

Ponteiro para uma variável que recebe uma cadeia de caracteres que contém o identificador de pino.

Retornar valor

Retorna um valor HRESULT . Os valores possíveis incluem aqueles mostrados na tabela a seguir.

Código de retorno Descrição
S_OK
 Êxito.
E_OUTOFMEMORY
 Memória insuficiente.
E_POINTER
 Argumento de ponteiro NULL.
VFW_E_NOT_FOUND
 O pino não foi encontrado no filtro.

Comentários

Esse método implementa o método IPin::QueryId . Para construir uma cadeia de caracteres de identificador, o pin chama o método CSource::FindPinNumber com ele mesmo como o parâmetro . O método FindPinNumber retorna o número do pino, indexado de zero. QueryId incrementa o valor retornado em um e converte o resultado em uma cadeia de caracteres. Por exemplo, o primeiro pino se torna "1"; o segundo pino se torna "2"; e assim por diante.

Se esse método retornar VFW_E_NOT_FOUND, ele indicará que a matriz de pinos do filtro é inválida, presumivelmente causada por um bug no filtro.

Requisitos

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

Confira também

Classe CSourceStream