Compartilhar via


IAgentCharacter::Interrupt

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas 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

Uma ID da solicitação a ser interrompida.

pdwReqID

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

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

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

Você não pode usar esse método para ter uma interrupção de caractere porque o servidor do Microsoft Agent enfileira o método Interrupt na fila de animação do caractere. Portanto, você só pode usar Interromper para interromper a animação de outro caractere carregado.