Partager via


en-tête portcls.h

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

portcls.h contient les interfaces de programmation suivantes :

Interfaces

 
IAdapterPnpManagement

IAdapterPnpManagement est une interface que les adaptateurs doivent implémenter et inscrire s’ils souhaitent 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 d’IUnknown et est utilisée pour gérer l’état d’alimentation d’un adaptateur 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 ses paramètres d’utilisation et de mémoire tampon DMA 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 WaveCyclique ou WavePci pour gérer le contenu protégé par DRM (voir Digital Rights Management).
IDrmPort2

L’interface IDrmPort2 est utilisée par un pilote WaveCyclique ou WavePci miniport 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 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 des propriétés KS qui accèdent au moteur audio via un handle de filtre KS.
IMiniportAudioSignalProcessing

L’interface IMiniportAudioSignalProcessing est implémentée par le composant miniport WaveRT d’un 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 midi miniport pour un appareil de synthétiseur MIDI.
IMiniportMidiStream

L’interface IMiniportMidiStream représente le flux MIDI qui transite par une broche sur un filtre MIDI.
IMiniportPnpNotify

IMiniportPnpNotify est une interface facultative permettant aux objets miniport (sous-appareils audio) de recevoir des notifications de modification d’état PnP.
IMiniportStreamAudioEngineNode

Cette interface permet à un pilote miniport d’utiliser des propriétés KS qui accèdent au moteur audio via un handle d’instance de broche.
IMiniportStreamAudioEngineNode2

L’interface IMiniportStreamAudioEngineNode2 permet à un pilote audio miniport d’étendre les fonctionnalités de l’interface IMiniportStreamAudioEngineNode.
IMiniportTopology

L’interface IMiniportTopology est l’interface principale d’un pilote miniport de topologie.
IMiniportWaveCyclique

L’interface IMiniportWaveCyclique est l’interface principale exposée par le pilote miniport pour un périphérique audio WaveCyclique.
IMiniportWaveCycliqueStream

L’interface IMiniportWaveCycliqueStream représente le flux d’onde qui transite par une broche sur un filtre WaveCyclique.
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 transite par 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’ondes 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 augmente l’interface IMiniportWaveRTStream, fournissant des méthodes supplémentaires pour faciliter les notifications d’événements du pilote DMA.
IMusicTechnology

L’interface IMusicTechnology est utilisée pour modifier les GUID de technologie musicale spécifiés dans les descripteurs de plage de données pour les broches appartenant à un pilote midi ou DMus miniport.
IPinCount

L’interface IPinCount fournit un moyen pour le pilote miniport de surveiller et de manipuler son nombre d’épingles dynamiquement, car 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 de l’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 des événements pour Windows (ETW).
IPortClsNotifications

Interface implémentée par les ports pour fournir des assistances de notification aux miniports pour 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 du 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 laquelle 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 une prise en charge générique du pilote de port à un pilote 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 de miniport WavePci.
IPortWaveRT

L’interface IPortWaveRT est prise en charge dans les systèmes d’exploitation Windows Vista et ultérieurs. Il s’agit de l’interface principale que le pilote de port WaveRT expose au pilote de l’adaptateur qui implémente l’objet du pilote miniport WaveRT.
IPortWaveRTStream

L’interface IPortWaveRTStream est prise en charge dans les systèmes d’exploitation Windows Vista et ultérieurs, et il s’agit d’une interface spécifique au flux qui fournit des méthodes d’assistance à utiliser par le pilote 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 du suivi des événements pour Windows (ETW) entre portCls et le pilote miniport.
IPowerNotify

L’interface IPowerNotify est une interface facultative que les pilotes miniports peuvent exposer s’ils nécessitent une notification préalable des modifications imminentes de l’état de l’alimentation.
IPreFetchOffset

L’interface IPreFetchOffset contrôle le décalage de prérécupération, qui correspond au nombre d’octets qui séparent 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 attribuées par le gestionnaire Plug-and-Play à un appareil au moment du démarrage.
IServiceGroup

L’interface IServiceGroup encapsule un groupe d’objets qui nécessitent toutes une 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-élément inscrit.

Fonctions

 
pcAddAdapterDevice

La fonction PcAddAdapterDevice ajoute un appareil adaptateur à la pile d’appareils 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 un IRP qui a été précédemment marqué comme étant en attente.
PcCompletePendingPropertyRequest

La fonction PcCompletePendingPropertyRequest est appelée pour effectuer 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 à partir 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 opération à 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 auquel 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 d’appareil 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 opération à 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’interruptions.
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 port-driver 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 crée 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 avec le pilote système PortCls. Il est utilisé pour prendre en charge le rééquilibrage PnP.
PcRegisterAdapterPowerManagement

La fonction PcRegisterAdapterPowerManagement inscrit l’interface de gestion de l’alimentation de l’adaptateur avec le pilote système PortCls.
PcRegisterIoTimeout

La fonction PcRegisterIoTimeout inscrit une routine de rappel 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 d’adaptateurs audio instanciés par le même pilote d’adaptateur.
PcRegisterPhysicalConnectionFromExternal

La fonction PcRegisterPhysicalConnectionFromExternal inscrit une connexion physique à un filtre d’adaptateur audio à partir d’un filtre d’adaptateur audio externe.
PcRegisterPhysicalConnectionToExternal

La fonction PcRegisterPhysicalConnectionToExternal inscrit une connexion physique à partir d’un filtre d’adaptateur audio à un filtre d’adaptateur audio externe.
PcRegisterSubdevice

La fonction PcRegisterSubdevice inscrit un sous-élément 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 par les pilotes d’adaptateur, mais peut parfois être utile pour contourner certains types de problèmes matériels.
PcUnregisterAdapterPnpManagement

La fonction PcUnregisterAdapterPnpManagement annule l’inscription de l’interface de gestion PnP de l’adaptateur audio à partir 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/O-timer 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 la table principale des propriétés, méthodes et é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, un épingle 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 pilote miniport d’un filtre. La structure spécifie les broches, nœuds, connexions et propriétés du filtre.
PCMETHOD_ITEM

La structure PCMETHOD_ITEM décrit une méthode prise en charge par un filtre, un épingle ou un nœud.
PCMETHOD_REQUEST

La structure PCMETHOD_REQUEST spécifie une requête de méthode.
PCNODE_DESCRIPTOR

La structure PCNODE_DESCRIPTOR décrit un nœud dans le filtre qu’un pilote 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 requête 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 glitching.
PC_EXIT_LATENCY

Cette rubrique décrit l’énumération PC_EXIT_LATENCY et décrit ses membres. Les temps de latence correspondent à des heures maximales spécifiques dans lesquelles l’appareil doit être en mesure de quitter son état de veille et d’entrer 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 un streaming audio spécifique.