Partilhar via


IAgentCharacter::Interrupção

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em versões subsequentes do Windows.]

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

Interrompe a animação especificada (solicitação) de outro caractere.

  • Retorna S_OK para indicar que a operação foi bem-sucedida. Quando a função retorna, pdwReqID contém a ID da solicitação.

dwReqID

Um ID da solicitação de interrupção.

pdwReqID

Endereço de uma variável que recebe a ID de solicitação de de interrupção.

Se você carregar vários caracteres, poderá usar esse método para sincronizar a animação entre os caracteres. Por exemplo, se outro caractere estiver em uma animação de looping, esse método interromperá a animação de looping e iniciará a próxima animação na fila do personagem.

Interromper interrompe a animação existente, mas não libera a fila de animação do personagem. Ele inicia a próxima animação na fila do personagem. Para interromper e liberar a fila de um caractere, use o método Stop.

Você não pode usar esse método para fazer com que um caractere se interrompa porque o servidor do Microsoft Agent enfileira o método Interrupt na fila de animação do personagem. Portanto, você só pode usar de interrupção para interromper a animação de outro personagem que você carregou.