IAgentCharacter ::Interrupt

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]

HRESULT Interrupt(
   long dwReqID,    // request ID to interrupt
   long * pdwReqID  // address of request ID
);

Interrompt l’animation spécifiée (requête) d’un autre caractère.

• Retourne S_OK pour indiquer que l’opération a réussi. Lorsque la fonction est retournée, pdwReqID contient l’ID de la requête.

dwReqID

ID de la requête à interrompre.

pdwReqID

Adresse d’une variable qui reçoit l’ID de demande d’interruption .

Si vous chargez plusieurs caractères, vous pouvez utiliser cette méthode pour synchroniser l’animation entre les caractères. Par exemple, si un autre caractère se trouve dans une animation en boucle, cette méthode arrête l’animation de bouclage et démarre l’animation suivante dans la file d’attente du caractère.

Interrompre arrête l’animation existante, mais ne vide pas la file d’attente d’animation du caractère. Elle démarre l’animation suivante dans la file d’attente du caractère. Pour arrêter et vider la file d’attente d’un caractère, utilisez la méthode Stop.

Vous ne pouvez pas utiliser cette méthode pour avoir une interruption de caractère elle-même, car le serveur Microsoft Agent met en file d’attente la méthode Interruption dans la file d’attente d’animation du caractère. Par conséquent, vous ne pouvez utiliser 'interruption pour arrêter l’animation d’un autre caractère que vous avez chargé.