IPortClsStreamResourceManager ::RemoveStreamResource, méthode (portcls.h)
RemoveStreamResource supprime une ressource de flux existante. La méthode RemoveStreamResource ne peut être utilisée que par les pilotes miniports waveRT audio.
Syntaxe
NTSTATUS RemoveStreamResource(
PCSTREAMRESOURCE ResourceHandle
);
Paramètres
ResourceHandle
PCSTREAMRESOURCE : handle de ressource retourné par PcAddStreamResource. Pour plus d’informations, consultez pcAddStreamResource.
Valeur de retour
Cette méthode retourne NTSTATUS qui contient :
- 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.
Le pilote audio doit s’assurer que la ressource est valide lors de cet appel.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | portcls.h |
| IRQL | PASSIVE_LEVEL |