en-tête portcls.h

Cet en-tête est utilisé par l’audio. Pour plus d'informations, consultez les pages suivantes :

• Audio

portcls.h contient les interfaces de programmation suivantes :

Interfaces

IAdapterPnpManagement IAdapterPnpManagement est une interface que les adaptateurs doivent implémenter et inscrire s’ils veulent recevoir des messages de gestion PnP.
IAdapterPowerManagement L’interface IAdapterPowerManagement est utilisée pour gérer l’état d’alimentation d’une carte audio.
IAdapterPowerManagement2 L’interface IAdapterPowerManagement2 hérite de IUnknown et est utilisée pour gérer l’état d’alimentation d’une carte audio.
IAdapterPowerManagement3 L’interface IAdapterPowerManagement3 hérite d’IUnknown et est utilisée pour recevoir des messages de gestion de l’alimentation.
IDmaChannel L’interface IDmaChannel fournit une abstraction d’un canal DMA et de sa mémoire tampon DMA et de ses paramètres d’utilisation associés.
IDmaChannelSlave L’interface IDmaChannelSlave fournit des méthodes pour surveiller et contrôler un canal DMA pour un appareil subordonné (comme décrit dans Introduction aux objets adaptateurs).
IDrmPort L’interface IDrmPort est utilisée par un pilote WaveCyclic ou WavePci miniport pour gérer le contenu protégé par DRM (voir Digital Rights Management).
IDrmPort2 L’interface IDrmPort2 est utilisée par un pilote miniport WaveCyclic ou WavePci pour gérer le contenu protégé par DRM (voir Digital Rights Management).
IInterruptSync L’interface IInterruptSync représente un objet de synchronisation d’interruption qui synchronise l’exécution d’une liste de routines de service d’interruption (ISR) avec des routines non-ISR.
IMiniport L’interface IMiniport est l’interface de miniport générique prise en charge par tous les objets miniport. IMiniport hérite de l’interface IUnknown.
IMiniportAudioEngineNode Cette interface permet à un pilote miniport d’utiliser les propriétés KS qui accèdent au moteur audio via une poignée de filtre KS.
IMiniportAudioSignalProcessing L’interface IMiniportAudioSignalProcessing est implémentée par le composant miniport WaveRT de n’importe quel pilote audio, si l’une de ses broches prend en charge les modes de traitement du signal audio.
IMiniportMidi L’interface IMiniportMidi est l’interface principale d’un pilote miniport MIDI pour un appareil de synthétiseur MIDI.
IMiniportMidiStream L’interface IMiniportMidiStream représente le flux MIDI qui traverse une broche sur un filtre MIDI.
IMiniportPnpNotify IMiniportPnpNotify est une interface facultative permettant aux objets miniports (sous-appareils audio) de recevoir des notifications de changement d’état PnP.
IMiniportStreamAudioEngineNode Cette interface permet à un pilote miniport d’utiliser les propriétés KS qui accèdent au moteur audio via une broche instance handle.
IMiniportStreamAudioEngineNode2 L’interface IMiniportStreamAudioEngineNode2 permet à un pilote de miniport audio d’étendre les fonctionnalités de l’interface IMiniportStreamAudioEngineNode.
IMiniportTopology L’interface IMiniportTopology est l’interface principale d’un pilote de miniport de topologie.
IMiniportWaveCyclic L’interface IMiniportWaveCyclic est l’interface principale exposée par le pilote miniport pour un périphérique audio WaveCyclic.
IMiniportWaveCyclicStream L’interface IMiniportWaveCyclicStream représente le flux d’ondes qui traverse une broche sur un filtre WaveCyclic.
IMiniportWavePci L’interface IMiniportWavePci est l’interface principale exposée par le pilote miniport pour un périphérique audio WavePci.
IMiniportWavePciStream L’interface IMiniportWavePciStream représente le flux d’ondes qui traverse une broche sur un filtre WavePci.
IMiniportWaveRT L’interface IMiniportWaveRT est l’interface principale exposée par le pilote miniport pour un périphérique audio WaveRT.
IMiniportWaveRTInputStream L’interface IMiniportWaveRTInputStream représente le flux d’onde d’entrée qui transite par une broche sur le filtre KS qui encapsule un appareil de rendu ou de capture WaveRT. IMiniportWaveRTInputStream hérite de l’interface IUnknown.
IMiniportWaveRTOutputStream L’interface IMiniportWaveRTOutputStream représente le flux d’onde de sortie. IMiniportWaveRTOutputStream hérite de l’interface IUnknown.
IMiniportWaveRTStream L’interface IMiniportWaveRTStream représente le flux d’ondes qui transite par une broche sur le filtre KS qui encapsule un appareil de rendu ou de capture WaveRT.
IMiniportWaveRTStreamNotification L’interface IMiniportWaveRTStreamNotification est prise en charge dans les systèmes d’exploitation Windows Vista et ultérieurs, et elle augmente l’interface IMiniportWaveRTStream, fournissant des méthodes supplémentaires pour faciliter les notifications d’événements du pilote DMA.
IMusicTechnology L’interface IMusicTechnology permet de modifier les GUID de technologie musicale spécifiés dans les descripteurs de plage de données pour les broches appartenant à un pilote de miniport MIDI ou DMus.
IPinCount L’interface IPinCount permet au pilote miniport de surveiller et de manipuler dynamiquement ses nombres de broches à mesure que les broches sont instanciées et fermées.
IPinName Dans les systèmes d’exploitation Windows 7 et ultérieurs, l’interface IPinName est utilisée par les pilotes miniport pour signaler et mettre à jour les noms des points de terminaison audio.
IPort L’interface IPort est l’interface générique pour les pilotes de port audio. Tous les pilotes de port audio exposent IPort dans le cadre de leur bord inférieur. Le pilote d’adaptateur appelle la méthode d’initialisation sur cette interface. IPort hérite de l’interface IUnknown.
IPortClsEtwHelper L’interface IPortClsEtwHelper permet à un pilote de miniport audio d’accéder aux fonctions d’assistance du suivi d’événements pour Windows (ETW).
IPortClsNotifications Interface implémentée par les ports pour fournir des aides de notification aux miniports afin de prendre en charge la communication de module audio.
IPortClsPnp IPortClsPnp est l’interface de gestion PnP que le pilote de classe de port (PortCls) expose à l’adaptateur.
IPortClsPower L’interface IPortClsPower est prise en charge dans Windows Vista et les versions ultérieures de Windows. IPortClsPower est l’interface de gestion de l’alimentation que le pilote de classe de port (PortCls) expose à l’adaptateur.
IPortClsRuntimePower IPortClsRuntimePower est l’interface utilisée par le pilote de classe de port (PortCls) pour accéder aux fonctionnalités de gestion de l’alimentation au runtime de la carte audio.
IPortClsStreamResourceManager IPortClsStreamResourceManager est utilisé pour gérer l’inscription des ressources de flux audio.
IPortClsStreamResourceManager2 IPortClsStreamResourceManager2 est utilisé pour gérer l’inscription des ressources de flux audio.
IPortClsVersion L’interface IPortClsVersion est utilisée par un pilote miniport pour identifier la version du système d’exploitation Windows sur lequel le pilote s’exécute. Le pilote de port implémente cette interface et l’expose au pilote miniport.
IPortEvents L’interface IPortEvents est utilisée par les pilotes miniport pour informer les clients des événements matériels.
IPortMidi L’interface IPortMidi est l’interface principale du pilote de port MIDI.
IPortTopology L’interface IPortTopology fournit la prise en charge du pilote de port générique pour un pilote de miniport de topologie.
IPortWaveCyclique L’interface IPortWaveCyclique est l’interface principale du pilote de port WaveCyclique.
IPortWavePci L’interface IPortWavePci est l’interface principale du pilote de port WavePci.
IPortWavePciStream L’interface IPortWavePciStream est l’interface de rappel associée au flux qui fournit des services de mappage aux objets de flux miniport WavePci.
IPortWaveRT L’interface IPortWaveRT est prise en charge dans Windows Vista et les systèmes d’exploitation ultérieurs, et il s’agit de l’interface main que le pilote de port WaveRT expose au pilote d’adaptateur qui implémente l’objet pilote miniport WaveRT.
IPortWaveRTStream L’interface IPortWaveRTStream est prise en charge dans Windows Vista et les systèmes d’exploitation ultérieurs, et il s’agit d’une interface spécifique au flux qui fournit des méthodes d’assistance à utiliser par le pilote de miniport WaveRT.
IPortWMIRegistration L’interface IPortWMIRegistration est fournie dans Windows 7 et versions ultérieures de Windows. Cette interface permet au pilote miniport de coordonner l’inscription event tracing for Windows (ETW) entre PortCls et le pilote miniport.
IPowerNotify L’interface IPowerNotify est une interface facultative que les pilotes miniport peuvent exposer s’ils nécessitent une notification préalable des modifications imminentes de l’état d’alimentation.
IPreFetchOffset L’interface IPreFetchOffset contrôle le décalage de prérécupération, qui est le nombre d’octets séparant les curseurs de lecture et d’écriture dans un flux de sortie DirectSound.
IRegistryKey L’interface IRegistryKey fournit une abstraction d’une clé de Registre qu’un pilote miniport peut utiliser pour accéder à la clé et à ses sous-clés.
IResourceList L’interface IResourceList fournit une abstraction d’une liste de ressources de configuration, qui est une liste des ressources matérielles système que le gestionnaire Plug-and-Play affecte à un appareil au moment du démarrage.
IServiceGroup L’interface IServiceGroup encapsule un groupe d’objets qui nécessitent tous la notification de la même demande de service.
IServiceSink L’interface IServiceSink encapsule la gestion d’une demande de service.
IUnregisterPhysicalConnection L’interface IUnregisterPhysicalConnection implémente trois méthodes pour supprimer une connexion physique inscrite.
IUnregisterSubdevice L’interface IUnregisterSubdevice implémente une méthode pour supprimer un sous-appareil inscrit.

Fonctions

PcAddAdapterDevice La fonction PcAddAdapterDevice ajoute un périphérique adaptateur à la pile de périphériques WDM.
PcAddContentHandlers La fonction PcAddContentHandlers fournit au système une liste de fonctions qui gèrent le contenu protégé.
PcAddStreamResource PcAddStreamResource ajoute une ressource de flux.
PcCompleteIrp La fonction PcCompleteIrp termine une IRP précédemment marquée comme étant en attente.
PcCompletePendingPropertyRequest La fonction PcCompletePendingPropertyRequest est appelée pour terminer une demande de propriété en attente.
PcCreateContentMixed La fonction PcCreateContentMixed calcule les droits de contenu DRM pour un flux composite contenant du contenu mixte provenant d’un certain nombre de flux audio KS.
PcDestroyContent La fonction PcDestroyContent supprime un ID de contenu DRM créé par PcCreateContentMixed. Notez que cet appel de fonction est identique en fonctionnement à la fonction DrmDestroyContent, et que ses définitions de paramètres et sa valeur de retour sont également identiques.
PcDispatchIrp La fonction PcDispatchIrp distribue un IRP au gestionnaire par défaut du pilote système PortCls.
PcForwardContentToDeviceObject La fonction PcForwardContentToDeviceObject accepte un objet d’appareil représentant un appareil vers lequel l’appelant a l’intention de transférer du contenu protégé.
PcForwardContentToFileObject La fonction PcForwardContentToFileObject est obsolète et est conservée uniquement pour prendre en charge les pilotes existants.
PcForwardContentToInterface La fonction PcForwardContentToInterface accepte un pointeur vers l’interface COM d’un objet vers lequel l’appelant a l’intention de transférer du contenu protégé.
PcForwardIrpSynchronous La fonction PcForwardIrpSynchronous est utilisée par les gestionnaires IRP pour transférer les irps Plug-and-Play à l’objet de périphérique physique (PDO).
PcGetContentRights La fonction PcGetContentRights récupère les droits de contenu DRM attribués à un ID de contenu DRM. Notez que cet appel de fonction est identique en fonctionnement à la fonction DrmGetContentRights, et que ses définitions de paramètres et sa valeur de retour sont également identiques.
PcGetDeviceProperty La fonction PcGetDeviceProperty retourne la propriété d’appareil demandée à partir du Registre.
PcGetPhysicalDeviceObject La fonction PcGetPhysicalDeviceObject permet aux pilotes de miniport audio de récupérer l’objet de périphérique physique sous-jacent du périphérique audio.
PcGetTimeInterval La fonction PcGetTimeInterval retourne le temps écoulé depuis une heure spécifiée. Le temps est mesuré en unités de 100 nanosecondes.
PcInitializeAdapterDriver La fonction PcInitializeAdapterDriver lie un pilote d’adaptateur au pilote système PortCls.
PcNewDmaChannel La fonction PcNewDmaChannel crée un objet de canal DMA. Cette fonction est obsolète ; Pour plus d’informations, consultez les commentaires suivants.
PcNewInterruptSync La fonction PcNewInterruptSync crée et initialise un objet de synchronisation d’interruption.
PcNewMiniport La fonction PcNewMiniport crée une instance de l’un des pilotes miniport fournis par le système qui sont intégrés au pilote système PortCls, portcls.sys.
PcNewPort La fonction PcNewPort crée un objet pilote de port fourni par le système, dont l’interface (dérivée de la classe de base IPort) est spécifiée par un ID de classe.
PcNewRegistryKey La fonction PcNewRegistryKey ouvre ou crée une clé de Registre et un objet IRegistryKey pour représenter la clé. L’appelant accède à la clé via cet objet.
PcNewResourceList La fonction PcNewResourceList crée et initialise une liste de ressources.
PcNewResourceSublist La fonction PcNewResourceSublist crée et initialise une liste de ressources vide dérivée d’une autre liste de ressources.
PcNewServiceGroup La fonction PcNewServiceGroup crée et initialise un groupe de services.
PcRegisterAdapterPnpManagement La fonction PcRegisterAdapterPnpManagement inscrit l’interface de gestion PnP de l’adaptateur auprès du pilote système PortCls. Il est utilisé pour prendre en charge le rééquilibrage PnP.
PcRegisterAdapterPowerManagement La fonction PcRegisterAdapterPowerManagement enregistre l’interface de gestion de l’alimentation de l’adaptateur auprès du pilote système PortCls.
PcRegisterIoTimeout La fonction PcRegisterIoTimeout inscrit une routine de rappel du minuteur d’E/S fournie par le pilote pour un objet d’appareil spécifié.
PcRegisterPhysicalConnection La fonction PcRegisterPhysicalConnection enregistre une connexion physique entre deux filtres de carte audio instanciés par le même pilote d’adaptateur.
PcRegisterPhysicalConnectionFromExternal La fonction PcRegisterPhysicalConnectionFromExternal inscrit une connexion physique à un filtre de carte audio à partir d’un filtre de carte audio externe.
PcRegisterPhysicalConnectionToExternal La fonction PcRegisterPhysicalConnectionToExternal enregistre une connexion physique à partir d’un filtre de carte audio vers un filtre de carte audio externe.
PcRegisterSubdevice La fonction PcRegisterSubdevice inscrit un sous-appareil pour le rendre disponible pour une utilisation par les clients.
PcRemoveStreamResource PcRemoveStreamResource supprime une ressource de flux existante.
PcRequestNewPowerState La fonction PcRequestNewPowerState est utilisée pour demander un nouvel état d’alimentation pour l’appareil. Cette fonction n’est généralement pas nécessaire pour les pilotes d’adaptateur, mais peut parfois être utile pour résoudre certains types de problèmes matériels.
PcUnregisterAdapterPnpManagement La fonction PcUnregisterAdapterPnpManagement annule l’inscription de l’interface de gestion PnP de l’adaptateur audio du pilote de classe PortCls. Il est utilisé pour prendre en charge le rééquilibrage PnP.
PcUnregisterAdapterPowerManagement La fonction PcUnregisterAdapterPowerManagement annule l’inscription de l’interface de gestion de l’alimentation de l’adaptateur audio à partir du pilote de classe PortCls. La fonction PcUnregisterAdapterPowerManagement est disponible dans Windows 7 et versions ultérieures de Windows.
PcUnregisterIoTimeout La fonction PcUnregisterIoTimeout annule l’inscription d’une routine de rappel d’E/S fournie par le pilote pour un objet d’appareil spécifié.

Fonctions de rappel

PCPFNEVENT_HANDLER Une routine EventHandler traite les demandes d’événements.

Structures

PCAUTOMATION_TABLE La structure PCAUTOMATION_TABLE contient les master table de propriétés, de méthodes et d’événements d’un pilote miniport.
PCEVENT_ITEM La structure PCEVENT_ITEM est utilisée pour décrire un événement pris en charge par un filtre, une broche ou un nœud particulier.
PCEVENT_REQUEST La structure PCEVENT_REQUEST spécifie une demande d’événement.
PCFILTER_DESCRIPTOR La structure PCFILTER_DESCRIPTOR décrit l’implémentation d’un filtre par un pilote miniport. La structure spécifie les broches, les nœuds, les connexions et les propriétés du filtre.
PCMETHOD_ITEM La structure PCMETHOD_ITEM décrit une méthode prise en charge par un filtre, une broche ou un nœud.
PCMETHOD_REQUEST La structure PCMETHOD_REQUEST spécifie une demande de méthode.
PCNODE_DESCRIPTOR La structure PCNODE_DESCRIPTOR décrit un nœud dans le filtre qu’un pilote de miniport de topologie implémente.
PCNOTIFICATION_BUFFER Mémoire tampon de notification utilisée par IPortClsNotifications.
PCPIN_DESCRIPTOR La structure PCPIN_DESCRIPTOR décrit une fabrique de broches.
PCPROPERTY_ITEM La structure PCPROPERTY_ITEM décrit une propriété prise en charge par un filtre, une broche ou un nœud particulier.
PCPROPERTY_REQUEST La structure PCPROPERTY_REQUEST spécifie une demande de propriété.
PCSTREAMRESOURCE_DESCRIPTOR PCSTREAMRESOURCE_DESCRIPTOR définit la ressource de flux. Utilisez PCSTREAMRESOURCE_DESCRIPTOR_INIT pour initialiser correctement cette structure.

Énumérations

eChannelTargetType L’énumération eChannelTargetType définit des constantes qui spécifient un type de nœud (cible) dans un canal donné.
eEngineFormatType L’énumération eEngineFormatType définit des constantes qui spécifient le type de données audio pris en charge par le moteur audio.
EPcMiniportEngineEvent Cette rubrique présente l’énumération EPcMiniportEngineEvent et décrit les paramètres qui fournissent des informations supplémentaires lorsque le pilote miniport signale une erreur de glitching.
PC_EXIT_LATENCY Cette rubrique traite de l’énumération PC_EXIT_LATENCY et décrit ses membres. Les temps de latence correspondent à des heures maximales spécifiques pendant lesquelles l’appareil doit être en mesure de quitter son état de veille et d’entrer dans l’état entièrement fonctionnel (D0).
PC_REBALANCE_TYPE L’énumération PC_REBALANCE_TYPE décrit le type de prise en charge du rééquilibrage.
PcStreamResourceType Cette rubrique décrit l’énumération PcStreamResourceType et décrit ses membres. L’énumération PcStreamResourceType est utilisée pour définir le type de ressources utilisées pour la diffusion en continu audio spécifique.