Fonction PcRemoveStreamResource (portcls.h)
PcRemoveStreamResource supprime une ressource de flux existante. PcRemoveStreamResource peut être appelé par n’importe quel pilote, y compris les pilotes miniport non audio WaveRT, qui a des interruptions/threads associés à un flux audio. Il peut également être appelé par les pilotes de miniport audio WaveRT.
Syntaxe
PORTCLASSAPI NTSTATUS PcRemoveStreamResource(
[in] PCSTREAMRESOURCE ResourceHandle
);
Paramètres
[in] ResourceHandle
PCSTREAMRESOURCE : handle de ressource retourné par PcAddStreamResource.
Pour plus d’informations, consultez pcAddStreamResource et PCSTREAMRESOURCE_DESCRIPTOR.
Valeur de retour
STATUS_SUCCESS : le pilote a pu inscrire la ressource du PDO spécifié.
STATUS_INVALID_PARAMETER : le pilote retourne cette erreur s’il trouve un autre paramètre non valide, en dehors des cas spécifiques pour d’autres instances d’état d’erreur.
Des codes d’état standard supplémentaires peuvent être retournés.
Remarques
Pour garantir l’opération sans glitch, les pilotes audio doivent inscrire leurs ressources de diffusion en continu auprès de portcls. Cela permet au système d’exploitation de gérer les ressources pour éviter les interférences entre le streaming audio et d’autres sous-systèmes.
Les ressources de flux sont toutes les ressources utilisées par le pilote audio pour traiter les flux audio ou garantir le flux de données audio.
Les pilotes audio doivent supprimer une ressource précédemment inscrite. Les pilotes peuvent annuler l’inscription d’une ressource en raison des activités système suivantes :
- Réécriture de l’appareil lorsque les ressources d’E/S changent.
- Transitions d’alimentation des appareils (D0<- ->Dx) lorsque les ressources sont détruites ou créées. Par exemple, les interruptions peuvent être déconnectées lorsque vous passez dans Dx et reconnectez-vous avec le retour à D0.
- Lors du traitement de l’arrêt, de la suppression surprise, de la suppression des événements plug-and-play.
- Lorsque les points de terminaison audio associés sont absents. Par exemple, si un thread est créé pour gérer le flux de données d’un point de terminaison et que le point de terminaison est supprimé. Dans ce cas, le pilote doit supprimer la ressource de flux de threads.
Les pilotes audio qui s’exécutent uniquement dans Windows 10 peuvent utiliser PcAddStreamResource et PcRemoveStreamResource. Pour les pilotes miniport audio waveRT qui doivent également s’exécuter sous les versions précédentes de Windows, utilisez AddStreamResource et RemoveStreamResource.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10 |
| serveur minimum pris en charge | Windows Server 2016 |
| plateforme cible | Windows |
| d’en-tête | portcls.h |
| bibliothèque | Portcls.lib |
| DLL | NA |
| IRQL | PASSIVE_LEVEL |