Compartilhar via


Método ITAllocatorProperties::SetAllocatorProperties (tapi3.h)

O método SetAllocatorProperties deve ser chamado antes da conexão e forçará o MSP a usar esses valores durante a negociação de filtro. Se o filtro de conexão não aceitar esses valores, a conexão não será estabelecida.

Sintaxe

HRESULT SetAllocatorProperties(
  [in] ALLOCATOR_PROPERTIES *pAllocProperties
);

Parâmetros

[in] pAllocProperties

Ponteiro para o buffer do alocador.

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Caso contrário, retornará um valor de erro.

Comentários

Esse método deve ser usado com extremo cuidado. A qualidade do som poderá sofrer se os valores inseridos para esse método não forem ideais para o MSP. Portanto, o aplicativo deve saber exatamente as propriedades preferidas pelo MSP antes de chamar esse método. No Windows 2000, as propriedades inseridas durante as chamadas para esse método serão ignoradas se não forem ideais. No Windows XP, esses valores não são ignorados e o aplicativo deve ser mais experiente.

Se o aplicativo estiver preocupado apenas com a configuração de tamanhos de buffer consistentes, o método ITAllocatorProperties::SetBufferSize deverá ser usado. Isso garante que o aplicativo seja fornecido com o tamanho do buffer especificado.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

ITAllocatorProperties