Método IToc::GetContext (wmcodecdsp.h)

  • Artigo

O método GetContext recupera um bloco de bytes que foi anteriormente associado ao sumário por uma chamada para SetContext.

Sintaxe

HRESULT GetContext(
  [in, out] DWORD *pdwContextSize,
  [out]     BYTE  *pbtContext
);

Parâmetros

[in, out] pdwContextSize

Se pbtContext for NULL, esse será um parâmetro de saída que recebe o tamanho, em bytes, do bloco de contexto. Se pbtContext não for NULL, esse será um parâmetro de entrada que especifica o tamanho, em bytes, do buffer alocado pelo chamador apontado por pbtContext.

[out] pbtContext

NULL ou um ponteiro para um buffer alocado pelo chamador que, após a conclusão bem-sucedida, recebe o bloco de contexto.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
MF_E_BUFFERTOOSMALL
 O método retornará esse código de erro se pbtContext não for NULL e o bloco de contexto for maior que o tamanho especificado por bdwContextSize. Nesse caso, pdwContextSize serve como um parâmetro de saída e recebe o tamanho, em bytes, do buffer necessário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wmcodecdsp.h
DLL Wmvdspa.dll

Confira também

IToc