Share via

Método IAudioProcessingObject::Initialize (audioenginebaseapo.h)

  • Artigo

O método Initialize inicializa o APO e dá suporte a dados de comprimento variável.

Sintaxe

HRESULT Initialize(
  [in] UINT32 cbDataSize,
  [in] BYTE   *pbyData
);

Parâmetros

[in] cbDataSize

Esse é o tamanho, em bytes, dos dados de inicialização.

[in] pbyData

São dados de inicialização específicos para esse APO.

Retornar valor

O Initialize método retornará um valor de S_OK se a chamada tiver sido bem-sucedida. Caso contrário, esse método retornará um dos seguintes códigos de erro:

Código de retorno Descrição
E_POINTER
 Ponteiro inválido passado para a função.
E_INVALIDARG
 Argumento inválido.
APOERR_ALREADY_INITIALIZED
 O APO já foi inicializado.
Outros HRESULTS
 Essas condições de erro adicionais são controladas pelo mecanismo de áudio.

Comentários

Se esse método for usado para inicializar um APO sem a necessidade de inicializar dados, será aceitável fornecer um NULL como o valor do parâmetro pbyData e um 0 (zero) como o valor do parâmetro cbDataSize. Os dados fornecidos têm comprimento variável e devem ter o seguinte formato:

Struct MyAPOInitializationData
{
APOInitBaseStruct APOInit;
// list additional struct members here
// ...
};

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível com o Windows Vista e sistemas operacionais Windows posteriores.
Plataforma de Destino Universal
Cabeçalho audioenginebaseapo.h
Biblioteca Audioenginebaseapo.idl
IRQL Qualquer nível

Confira também

APOInitBaseStruct