IAudioProcessingObject::Initialize-Methode (audioenginebaseapo.h)

Die Initialize-Methode initialisiert den APO und unterstützt Daten mit variabler Länge.

Syntax

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

Parameter

[in] cbDataSize

Dies ist die Größe der Initialisierungsdaten in Bytes.

[in] pbyData

Dies sind Initialisierungsdaten, die für diesen APO spezifisch sind.

Rückgabewert

Die Initialize Methode gibt den Wert S_OK zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt diese Methode einen der folgenden Fehlercodes zurück:

Rückgabecode Beschreibung
E_POINTER
Ungültiger Zeiger, der an die Funktion übergeben wurde.
E_INVALIDARG
Ungültiges Argument.
APOERR_ALREADY_INITIALIZED
APO wurde bereits initialisiert.
Andere HRESULTS
Diese zusätzlichen Fehlerbedingungen werden von der Audio-Engine nachverfolgt.

Hinweise

Wenn diese Methode verwendet wird, um einen APO zu initialisieren, ohne dass Daten initialisiert werden müssen, ist es akzeptabel, einen NULL-Wert als Wert des pbyData-Parameters und 0 (null) als Wert des cbDataSize-Parameters anzugeben. Die bereitgestellten Daten haben eine variable Länge und müssen das folgende Format aufweisen:

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar mit Windows Vista und höheren Windows-Betriebssystemen.
Zielplattform Universell
Header audioenginebaseapo.h
Bibliothek Audioenginebaseapo.idl
IRQL Beliebige Ebene

Weitere Informationen

APOInitBaseStruct