Método ISampleGrabber::GetConnectedMediaType

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

Observação

[Preterido. Essa API pode ser removida de versões futuras do Windows.]

 

O GetConnectedMediaType método recupera o tipo de mídia para a conexão no pino de entrada do Grabber de Exemplo.

Sintaxe

HRESULT GetConnectedMediaType(
   AM_MEDIA_TYPE *pType
);

Parâmetros

pType

Ponteiro para uma estrutura AM_MEDIA_TYPE alocada pelo chamador.

Retornar valor

Retorna um dos valores a seguir.

Código de retorno	Descrição
E_POINTER	Argumento de ponteiro NULL.
S_OK	Êxito.
VFW_E_NOT_CONNECTED	O filtro não está conectado.

 

Comentários

Esse método copia o tipo de mídia para a estrutura AM_MEDIA_TYPE especificada por pType. O chamador deve liberar o bloco de formato do tipo de mídia. Você pode usar a função CoTaskMemFree ou a função FreeMediaType na biblioteca de classe base.

Observação

O arquivo de cabeçalho Qedit.h não é compatível com cabeçalhos Direct3D posteriores à versão 7.

 

Observação

Para obter qedit.h, baixe o SDK do Microsoft Windows Update para Windows Vista e .NET Framework 3.0. O Qedit.h não está disponível no SDK do Microsoft Windows para Windows 7 e .NET Framework 3.5 Service Pack 1.

 

Requisitos

Requisito	Valor
parâmetro	Qedit.h
Biblioteca	Strmiids.lib

Confira também

Usando o grabber de exemplo

ISampleGrabber Interface