Compartilhar via

Método IMFByteStream::GetCapabilities (mfobjects.h)

  • Artigo

Recupera as características do fluxo de bytes.

Sintaxe

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilities
);

Parâmetros

[out] pdwCapabilities

Recebe um OR bit a bit de zero ou mais sinalizadores. Os sinalizadores a seguir são definidos.

Valor Significado
MFBYTESTREAM_IS_READABLE
0x00000001
 O fluxo de bytes pode ser lido.
MFBYTESTREAM_IS_WRITABLE
0x00000002
 O fluxo de bytes pode ser gravado.
MFBYTESTREAM_IS_SEEKABLE
0x00000004
 O fluxo de bytes pode ser buscado.
MFBYTESTREAM_IS_REMOTE
0x00000008
 O fluxo de bytes é de uma fonte remota, como uma rede.
MFBYTESTREAM_IS_DIRECTORY
0x00000080
 O fluxo de bytes representa um diretório de arquivo.
MFBYTESTREAM_HAS_SLOW_SEEK
0x00000100
 A busca dentro desse fluxo pode ser lenta. Por exemplo, o fluxo de bytes pode ser baixado de uma rede.
MFBYTESTREAM_IS_PARTIALLY_DOWNLOADED
0x00000200
 No momento, o fluxo de bytes está baixando dados para um cache local. As operações de leitura no fluxo de bytes podem levar mais tempo até que os dados sejam completamente baixados.

Esse sinalizador é limpo depois que todos os dados são baixados.

Se o sinalizador MFBYTESTREAM_HAS_SLOW_SEEK também estiver definido, isso significa que o fluxo de bytes deve baixar todo o arquivo sequencialmente. Caso contrário, o fluxo de bytes pode responder às solicitações de busca reiniciando o download de um novo ponto no fluxo.
MFBYTESTREAM_SHARE_WRITE
0x00000400
 Outro thread ou processo pode abrir esse fluxo de bytes para gravação. Se esse sinalizador estiver presente, o comprimento do fluxo de bytes poderá ser alterado enquanto ele estiver sendo lido.

Esse sinalizador pode afetar o comportamento de manipuladores de fluxo de bytes. Para obter mais informações, consulte MF_BYTESTREAMHANDLER_ACCEPTS_SHARE_WRITE.

Nota Requer o Windows 7 ou posterior.
 
MFBYTESTREAM_DOES_NOT_USE_NETWORK
0x00000800
 No momento, o fluxo de bytes não está usando a rede para receber o conteúdo. O hardware de rede pode entrar em um estado de economia de energia quando esse bit é definido.
Nota Requer Windows 8 ou posterior.
 

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

Essa interface estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

  • Windows XP com Service Pack 2 (SP2) e posterior.
  • Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (pacote cumulativo de atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfobjects.h (inclua Mfidl.h)
Biblioteca Mfuuid.lib

Confira também

IMFByteStream