KSPROPERTY_RTAUDIO_SETWRITEPACKET
KSPROPERTY_RTAUDIO_SETWRITEPACKET informe le pilote que le système d’exploitation a écrit des données valides dans la mémoire tampon WaveRT.
Tableau récapitulatif de l’utilisation
| Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
| Non | Oui | Épingle | KSPROPERTY | KSRTAUDIO_SETWRITEPACKET_INFO |
Le descripteur de propriété (instance données) est une structure KSPROPERTY. Avant d’envoyer la demande, le client charge la structure avec des valeurs qui incluent le numéro de paquet, la longueur du paquet et d’autres informations.
La valeur de la propriété est une structure de type KSRTAUDIO_SETWRITEPACKET_INFO.
Valeur de retour
Une demande de propriété KSPROPERTY_RTAUDIO_SETWRITEPACKET retourne STATUS_SUCCESS pour indiquer qu’elle s’est terminée avec succès. Sinon, la requête retourne un échec approprié status code.
Notes
Si ce KSPROPERTY est pris en charge, le pilote peut éventuellement utiliser les informations fournies pour optimiser le transfert matériel. Par exemple, le pilote peut optimiser les transferts DMA ou programmer du matériel pour arrêter le transfert à la fin du paquet spécifié au cas où le système d’exploitation n’appelle pas à nouveau cette routine pour informer le pilote d’un autre paquet. Cela peut atténuer les effets audibles du sous-flux, par exemple l’introduction d’un espace sonore au lieu de répéter une mémoire tampon circulaire. Toutefois, le pilote est toujours obligé d’augmenter son compteur de paquets interne et les événements de notification de signal à un taux nominal en temps réel.
Sauf lorsque le système d’exploitation spécifie l’indicateur de KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM , la taille du paquet est la taille de la mémoire tampon WaveRT divisée par notificationCount passée à KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION.
Selon les fonctionnalités matérielles, si l’indicateur de KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM est spécifié, le pilote peut remplir sans silence une partie de la mémoire tampon WaveRT qui suit le paquet EOS au cas où le matériel transfère des données au-delà de la position EOS.
Spécifications
Version |
Disponible dans les systèmes d’exploitation Windows Windows 10 et versions ultérieures. |
En-tête |
Ksmedia.h |