IAcpHal::Connect
Se connecte à l’ACP.Syntaxe
Paramètres
numCommandsType : UINT32 Spécifie le nombre de commandes à allouer dans la file d’attente de commandes de l’ACP. Cette valeur doit être supérieure à zéro et suffisamment grande pour gérer autant de commandes que celles émises pour chaque trame audio de 2,67 ms. numMessages
Type : UINT32 Spécifie le nombre de messages à allouer dans la file d’attente de messages de l’ACP. Cette valeur peut être égale à zéro si le titre ne traite pas les messages reçus. Si une inscription aux messages de commande terminée (voir ACP_MESSAGE_TYPE) a été effectuée, il y aura au moins autant de messages que de commandes. En général, cette file d’attente de messages est traitée moins d’une fois par trame audio ; prévoyez donc l’équivalent de plusieurs trames de messages.
Valeur renvoyée
Type : HRESULT Si la méthode réussit, elle renvoieS_OK. Si la méthode échoue, elle renvoie l’un des codes suivants (liste partielle) :
Remarques
Appelez cette méthode avant d’appeler toute autre méthode de cette interface. Toutefois, après avoir appelé Disconnect, vous pouvez appeler à nouveau cette méthode. Voir aussi SubmitCommand. Si la méthode échoue en raison d’une erreur autre queE_INVALIDARG ou ACP_E_ALREADY_CONNECTED, il est recommandé de détruire tous les objets clients ACP existants et de libérer les contextes SHAPE alloués à l’aide de AcpHalReleaseShapeContexts. De nouveaux contextes SHAPE et objets clients ACP doivent ensuite être alloués/créés à nouveau selon les besoins à l’aide de AcpHalAllocateShapeContexts et AcpHalCreate respectivement.
Configuration requise
En-tête : acphal.h Plateformes prises en charge : consoles de la famille XBOX One et consoles XBOX SeriesVoir aussi
DisconnectAcpHal