Fonction PcAddStreamResource (portcls.h)

  • Article

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 de 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 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 étendues à l’appareil sont actuellement prises en charge.

[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 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.

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 d’autres ressources de la pile audio (par 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 l’exécution de cet appel.

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

Voir aussi

PCSTREAMRESOURCE_DESCRIPTOR

PcRemoveStreamResource