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 (requête) spécifiée d’un autre caractère.

• Retourne S_OK pour indiquer que l’opération a réussi. Lorsque la fonction retourne, pdwReqID contient l’ID de la demande.

dwReqID

ID de la demande à 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 de boucle, cette méthode arrête l’animation de boucle et démarre l’animation suivante dans la file d’attente du caractère.

L’interruption arrête l’animation existante, mais ne vide pas la file d’attente d’animation du caractère. Il 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 qu’un caractère s’interrompe lui-même, car le serveur Microsoft Agent met en file d’attente la méthode Interrupt dans la file d’attente d’animation du caractère. Par conséquent, vous pouvez uniquement utiliser l’interruption pour arrêter l’animation d’un autre caractère que vous avez chargé.