Compartilhar via


Método IAMStreamConfig::GetNumberOfCapabilities (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 GetNumberOfCapabilities método recupera o número de funcionalidades de formato compatíveis com esse pin.

Sintaxe

HRESULT GetNumberOfCapabilities(
  [out] int *piCount,
  [out] int *piSize
);

Parâmetros

[out] piCount

Ponteiro para uma variável que recebe o número de recursos de formato.

[out] piSize

Ponteiro para uma variável que recebe o tamanho da estrutura de configuração em bytes. Confira Comentários para obter mais informações.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno Descrição
S_OK
Êxito.
E_POINTER
Valor do ponteiro NULL .
VFW_E_NOT_CONNECTED
O pino de entrada não está conectado.

Comentários

Um pin de saída pode dar suporte a mais de um conjunto de recursos de formato. Esse método retorna o número total de funcionalidades compatíveis com o pin; o número é retornado no parâmetro piCount . Para recuperar um determinado conjunto de recursos, chame o método IAMStreamConfig::GetStreamCaps . As funcionalidades de formato são indexadas a partir de zero, portanto, o valor retornado em piCount é um a mais do que o limite superior.

Dependendo do tipo de formato do pino, a estrutura de VIDEO_STREAM_CONFIG_CAPS (para vídeo) ou uma estrutura de AUDIO_STREAM_CONFIG_CAPS (para áudio). O parâmetro piSize recebe o tamanho da estrutura, em bytes.

Em alguns filtros de compactação, esse método falhará se o pino de entrada do filtro não estiver conectado.

Requisitos

   
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

IAMStreamConfig Interface