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

El método Initialize inicializa el APO y admite datos de longitud variable.

Sintaxis

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

Parámetros

[in] cbDataSize

Este es el tamaño, en bytes, de los datos de inicialización.

[in] pbyData

Se trata de datos de inicialización específicos de este APO.

Valor devuelto

El Initialize método devuelve un valor de S_OK si la llamada se realizó correctamente. De lo contrario, este método devuelve uno de los siguientes códigos de error:

Código devuelto	Descripción
E_POINTER	Puntero no válido pasado a la función.
E_INVALIDARG	Argumento no válido.
APOERR_ALREADY_INITIALIZED	APO ya se ha inicializado.
Otros HRESULT	El motor de audio realiza el seguimiento de estas condiciones de error adicionales.

Comentarios

Si este método se usa para inicializar un APO sin necesidad de inicializar ningún dato, es aceptable proporcionar un valor NULL como el valor del parámetro pbyData y un 0 (cero) como valor del parámetro cbDataSize. Los datos proporcionados son de longitud variable y deben tener el formato siguiente:

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible con Windows Vista y sistemas operativos Windows posteriores.
Plataforma de destino	Universal
Encabezado	audioenginebaseapo.h
Library	Audioenginebaseapo.idl
IRQL	Cualquier nivel

Consulte también

APOInitBaseStruct