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 WaveRT non audio, qui a des interruptions/threads associés à un flux audio. Il peut également être appelé par les pilotes audio WaveRT miniport.
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 retournée
STATUS_SUCCESS : le pilote a pu inscrire la ressource de l’AOP spécifié.
STATUS_INVALID_PARAMETER : le pilote retourne cette erreur s’il trouve un autre paramètre non valide, à l’exception des cas spécifiques pour d’autres instances d’erreur status.
Des codes de status standard supplémentaires peuvent être retournés.
Remarques
Pour garantir un fonctionnement sans problème, 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 afin d’éviter les interférences entre le streaming audio et d’autres sous-systèmes.
Stream ressources sont toutes les ressources utilisées par le pilote audio pour traiter des 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 à la suite des activités système suivantes :
- Réélibrer l’appareil lorsque les ressources d’E/S changent.
- Transitions d’alimentation d’appareil (D0<- ->Dx) lorsque des ressources sont détruites ou créées. Par exemple, les interruptions peuvent être déconnectées lors de l’utilisation de Dx et reconnectées avec le retour à D0.
- Lors du traitement des événements stop, surprise-remove, remove, remove plug-and-play.
- Lorsque les points de terminaison audio associés disparaissent. 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 de miniport audio waveRT qui doivent également s’exécuter sous les versions précédentes de Windows, utilisez AddStreamResource et RemoveStreamResource.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10 |
| Serveur minimal pris en charge | Windows Server 2016 |
| Plateforme cible | Windows |
| En-tête | portcls.h |
| Bibliothèque | Portcls.lib |
| DLL | N/D |
| IRQL | PASSIVE_LEVEL |