Método IMFSinkWriter::GetServiceForStream (mfreadwrite.h)
Consulta o coletor de mídia ou o codificador subjacente para uma interface.
Sintaxe
HRESULT GetServiceForStream(
[in] DWORD dwStreamIndex,
[in] REFGUID guidService,
[in] REFIID riid,
[out] LPVOID *ppvObject
);
Parâmetros
[in] dwStreamIndex
O índice baseado em zero de um fluxo a ser consultado ou MF_SINK_WRITER_MEDIASINK para consultar o próprio coletor de mídia.
[in] guidService
Um GUID de identificador de serviço ou GUID_NULL. Se o valor for GUID_NULL, o método chamará QueryInterface para obter a interface solicitada. Caso contrário, o método chamará IMFGetService::GetService. Para obter uma lista de identificadores de serviço, consulte Interfaces de serviço.
[in] riid
O IID (identificador de interface) da interface que está sendo solicitada.
[out] ppvObject
Recebe um ponteiro para a interface solicitada. O chamador deve liberar a interface.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Se o parâmetro dwStreamIndex for igual a MF_SINK_WRITER_MEDIASINK, o método tentará obter a interface do coletor de mídia. Caso contrário, ele tentará obter a interface do codificador para o fluxo no índice especificado. Se isso falhar ou se nenhum codificador estiver presente, o método tentará obter a interface do fluxo no coletor de mídia.
Se os tipos de entrada e saída do coletor forem idênticos e compactados, é possível que nenhuma codificação seja necessária e o codificador de vídeo não seja instanciado. Nesse caso, GetServiceForStream retornará MF_E_UNSUPPORTED_SERVICE.
Essa interface estará disponível no Windows Vista se o Suplemento de Atualização de Plataforma para Windows Vista estiver instalado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Suplemento Windows 7, Windows Vista e Platform Update para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | mfreadwrite.h |