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