Fonction PcAddStreamResource (portcls.h)
PcAddStreamResource ajoute une ressource de flux. Deux types de ressources de flux sont pris en charge : les interruptions et les threads appartenant au pilote. PcAddStreamResource peut être appelé par n’importe quel pilote 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 PcAddStreamResource(
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in] PVOID ResourceSet,
[in] PPCSTREAMRESOURCE_DESCRIPTOR ResourceDescriptor,
[out] PCSTREAMRESOURCE *ResourceHandle
);
Paramètres
[in] PhysicalDeviceObject
PDEVICE_OBJECT : PDO de la pile d’appareils à l’aide de cette ressource.
[in] ResourceSet
PVOID - Réservé pour une utilisation ultérieure, défini sur NULL. Seules les ressources délimitées à l’appareil sont prises en charge pour l’instant.
[in] ResourceDescriptor
PPCSTREAMRESOURCE_DESCRIPTOR : ressource à ajouter. Pour plus d’informations, consultez PCSTREAMRESOURCE_DESCRIPTOR.
[out] ResourceHandle
PCSTREAMRESOURCE* : emplacement qui contiendra le handle de ressource. Pour plus d’informations, consultez PcRemoveStreamResource.
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.
Tous les pilotes audio doivent inscrire leurs ressources de flux auprès du pilote de classe audio. Le pilote inscrit les types de ressources suivants : interruptions, threads appartenant au pilote et dépendances sur les ressources d’autres piles audio (exemple : piles de pilotes audio parallèles). Pour plus d’informations, consultez la définition de PCSTREAMRESOURCE_DESCRIPTOR.
Le pilote audio doit s’assurer que la ressource est valide lors de cet appel.
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 |