XDspSubmitCommand
Soumet une commande à la file d’attente matérielle pour un flux XDSP donné.Syntaxe
Paramètres
handle _In_Type : XDspStreamHandle Handle de flux XDSP valide. command _In_
Type : XDspCommand* Pointeur vers une structure XDspCommand. commandSequence _Out_
Type : uint32_t* Pointeur vers un
uint32_t permettant de retourner une valeur de séquence de commande. Consultez la section Remarques pour plus de détails.
Valeur de retour
Type : HRESULT Si la méthode réussit, elle retourne S_OK. Si la méthode échoue, elle retourne le code suivant (liste partielle) :Remarques
Cet appel est rapide, car il n’alloue pas de ressources et ne traite pas de données; il envoie simplement la commande au serveur matériel. Cet appel accepte également un pointeur vers unuint32_t pour retourner une valeur de séquence de commande, commandSequence, qui permet de savoir plus tard quand le résultat de la commande est prêt. Ce nombre représente le nombre total de commandes qui ont été soumises avec succès depuis le début de la session et après l’appel de XDspActivate. Ce nombre vaut un pour la première commande et est incrémenté de un pour chaque appel réussi à XDspSubmitCommand par la suite.
Si le serveur matériel est dans un état incorrect, XDspSubmitCommand retourne le code d’erreur XDSP_E_DEVICE_FATAL_ERROR. À ce moment, aucune autre commande ne peut être soumise pour le flux XDSP en état d’échec. XDspStatus pour le flux indiquera également la même erreur. Le flux XDSP touché doit attendre que toutes les commandes soumises soient traitées par le matériel en vérifiant XDspStatus, et il doit être désactivé à l’aide de XDspDeactivate une fois toutes les commandes traitées. Les autres flux XDSP ne seront pas touchés et le matériel continuera de traiter leurs commandes.
Configuration requise
En-tête : XDspAudio.h Bibliothèque : Chad.lib Plateformes prises en charge : XBOX Series X|SDocumentation conceptuelle
- Vue d’ensemble de l’enveloppe XDSP
- Vue d’ensemble d’une convolution à flux unique avec enveloppe à l’aide de l’API XDSP
- Vue d’ensemble d’une convolution à flux unique à l’aide de l’API XDSP
- Vue d’ensemble de XDSP
Voir aussi
XDSPXDspSubmitCommandWithEnvelope
Erreurs XDSP
Vue d’ensemble d’une convolution à flux unique à l’aide de l’API XDSP
Vue d’ensemble d’une FFT/IFFT à flux unique à l’aide de l’API XDSP
Vue d’ensemble d’une convolution à flux unique avec enveloppe à l’aide de l’API XDSP