Méthode IUserNotification ::P laySound (shobjidl_core.h)
Lit un son conjointement avec la notification.
Syntaxe
HRESULT PlaySound(
[in] LPCWSTR pszSoundName
);
Paramètres
[in] pszSoundName
Type : LPCWSTR
Pointeur vers une chaîne Unicode terminée par null qui spécifie l’alias du fichier audio à lire.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
La chaîne pointée par pszSoundNamepqc contient un alias pour un événement système trouvé dans le registre ou le fichier Win.ini ; pour instance, « SystemExit ».
Le son spécifié est lu de manière asynchrone et la méthode retourne immédiatement après le début du son. Pour arrêter un son de forme d’onde asynchrone, appelez IUserNotification ::P laySound avec pszSoundNamepqc défini sur NULL.
L’événement sonore spécifié est généré à un autre événement sonore qui est déjà en cours de lecture. Si un son ne peut pas être lu parce que la ressource nécessaire à la lecture de ce son est occupée, la méthode retourne immédiatement S_FALSE sans lire le son demandé.
Si le son spécifié est introuvable, IUserNotification ::P laySound utilise le son par défaut du système.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | shobjidl_core.h (incluez Shobjidl.h) |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour