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 nulle si le titre ne traite pas les messages reçus. Si une inscription aux messages command completed (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 des messages pour plusieurs trames.
Valeur de retour
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 cette méthode de nouveau. Consultez également SubmitCommand. Si la méthode échoue en raison d’une erreur autre queE_INVALIDARG ou ACP_E_ALREADY_CONNECTED, il est conseillé 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 ou créés au besoin à l’aide de AcpHalAllocateShapeContexts et de 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