Méthode IAudioProcessingObject ::Initialize (audioenginebaseapo.h)
La méthode Initialize initialise l’APO et prend en charge les données de longueur variable.
Syntaxe
HRESULT Initialize(
[in] UINT32 cbDataSize,
[in] BYTE *pbyData
);
Paramètres
[in] cbDataSize
Il s’agit de la taille, en octets, des données d’initialisation.
[in] pbyData
Il s’agit des données d’initialisation spécifiques à cette APO.
Valeur retournée
La Initialize méthode retourne une valeur de S_OK si l’appel a réussi. Sinon, cette méthode retourne l’un des codes d’erreur suivants :
| Code de retour | Description |
|---|---|
|
Pointeur non valide passé à la fonction. |
|
Argument non valide. |
|
APO déjà initialisé. |
|
Ces conditions d’erreur supplémentaires sont suivies par le moteur audio. |
Remarques
Si cette méthode est utilisée pour initialiser un APO sans avoir à initialiser des données, il est acceptable de fournir une valeur NULL comme valeur du paramètre pbyData et une valeur 0 (zéro) comme valeur du paramètre cbDataSize. Les données fournies sont de longueur variable et doivent avoir le format suivant :
Struct MyAPOInitializationData
{
APOInitBaseStruct APOInit;
// list additional struct members here
// ...
};
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible avec les systèmes d’exploitation Windows Vista et ultérieurs. |
| Plateforme cible | Universal |
| En-tête | audioenginebaseapo.h |
| Bibliothèque | Audioenginebaseapo.idl |
| IRQL | N’importe quel niveau |