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 |
|---|---|
|
Ungültiger Zeiger, der an die Funktion übergeben wurde. |
|
Ungültiges Argument. |
|
APO wurde bereits initialisiert. |
|
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 |