KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT
La propriété KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT annule l’inscription d’un événement en mode utilisateur de la notification d’événement pilotée par DMA.
Le tableau suivant récapitule les fonctionnalités de cette propriété.
Tableau récapitulatif de l’utilisation
Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
---|---|---|---|---|
Oui |
Oui |
Épingle |
NULL |
Le descripteur de propriété (instance données) se compose d’une structure KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY qui contient une structure KSPROPERTY ainsi qu’un handle d’événement en mode utilisateur.
La valeur de la propriété (données d’opération) de cette propriété est NULL , car aucune donnée d’opération n’est retournée.
Valeur de retour
Une demande de propriété KSPROPERTY_ RTAUDIO_UNREGISTER_NOTIFICATION_EVENT retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, la requête retourne un échec approprié status code. Le tableau suivant présente certains des échecs possibles status codes.
Code d’état | Signification |
---|---|
STATUS_NOT_SUPPORTED |
Les notifications d'événements ne sont pas prises en charge. |
STATUS_INSUFFICIENT_RESOURCES |
La mémoire pour la mémoire tampon ne peut pas être allouée. |
STATUS_DEVICE_NOT_READY |
Le périphérique n’est pas prêt. |
Notes
Cette propriété est utilisée pour désinscrire les événements en mode utilisateur de la notification d’événements pilotée par DMA.
Lorsque l’épingle est placée dans l’état d’exécution (KSSTATE_RUN), les événements inscrits sont signalés une ou deux fois par cycle de la mémoire tampon audio cyclique, en fonction du nombre de notifications demandé lors de l’appel de KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION . Pour plus d’informations sur KSSTATE_RUN, consultez la rubrique Transitions d’état .
Après avoir arrêté l’épingle et avant l’étape où vous la fermez, chaque événement inscrit doit être désinscrit via un appel à KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT.
Spécifications
Version |
Disponible dans les systèmes d’exploitation Windows Vista et ultérieurs. |
En-tête |
Ksmedia.h |
Voir aussi
KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY