intestazione portcls.h

Articolo
08/07/2023

Questa intestazione viene usata dall'audio. Per altre informazioni, vedere:

Audio

portcls.h contiene le interfacce di programmazione seguenti:

Interfacce


IAdapterPnpManagement IAdapterPnpManagement è un'interfaccia che gli adapter devono implementare e registrare se vogliono ricevere messaggi di gestione PnP.
IAdapterPowerManagement L'interfaccia IAdapterPowerManagement viene usata per gestire lo stato di alimentazione di una scheda audio.
IAdapterPowerManagement2 L'interfaccia IAdapterPowerManagement2 eredita da IUnknown e viene usata per gestire lo stato di alimentazione di un adattatore audio.
IAdapterPowerManagement3 L'interfaccia IAdapterPowerManagement3 eredita da IUnknown e viene usata per ricevere messaggi di risparmio energia.
IDmaChannel L'interfaccia IDmaChannel fornisce un'astrazione di un canale DMA e dei relativi parametri di utilizzo e buffer DMA associati.
IDmaChannelSlave L'interfaccia IDmaChannelSlave fornisce metodi per il monitoraggio e il controllo di un canale DMA per un dispositivo subordinato, come descritto in Introduzione agli oggetti adapter.
IDrmPort L'interfaccia IDrmPort viene usata da un driver WaveCyclic o WavePci miniport per gestire il contenuto protetto da DRM (vedere Digital Rights Management).
IDrmPort2 L'interfaccia IDrmPort2 viene usata da un driver WaveCyclic o WavePci miniport per gestire contenuti protetti da DRM (vedere Digital Rights Management).
IInterruptSync L'interfaccia IInterruptSync rappresenta un oggetto di sincronizzazione di interruzioni che sincronizza l'esecuzione di un elenco di routine del servizio di interruzione (ISR) con routine non ISR.
IMiniport L'interfaccia IMiniport è l'interfaccia miniport generica supportata da tutti gli oggetti miniport. IMiniport eredita dall'interfaccia IUnknown.
IMiniportAudioEngineNode Questa interfaccia consente a un driver miniport di usare le proprietà KS che accedono al motore audio tramite un handle di filtro KS.
IMiniportAudioSignalProcessing L'interfaccia IMiniportAudioSignalProcessing viene implementata dal componente miniport WaveRT di qualsiasi driver audio, se uno dei relativi pin supporta le modalità di elaborazione del segnale audio.
IMiniportMidi L'interfaccia IMiniportMidi è l'interfaccia primaria per un driver miniport MIDI per un dispositivo di sintetizzatore MIDI.
IMiniportMidiStream L'interfaccia IMiniportMidiStream rappresenta il flusso MIDI che scorre attraverso un pin su un filtro MIDI.
IMiniportPnpNotify IMiniportPnpNotify è un'interfaccia facoltativa per consentire agli oggetti miniport (sottodevice audio) di ricevere notifiche di modifica dello stato PnP.
IMiniportStreamAudioEngineNode Questa interfaccia consente a un driver miniport di usare le proprietà KS che accedono al motore audio tramite un handle di istanza di pin.
IMiniportStreamAudioEngineNode2 L'interfaccia IMiniportStreamAudioNode2 consente a un driver miniport audio di estendere le funzionalità dell'interfaccia IMiniportStreamAudioEngineNode.
IMiniportTo topologia L'interfaccia IMiniportTopology è l'interfaccia primaria di un driver miniport della topologia.
IMiniportWaveCyclic L'interfaccia IMiniportWaveCyclic è l'interfaccia primaria esposta dal driver miniport per un dispositivo audio WaveCyclic.
IMiniportWaveCyclicStream L'interfaccia IMiniportWaveCyclicStream rappresenta il flusso di onda che scorre attraverso un pin su un filtro WaveCyclic.
IMiniportWavePci L'interfaccia IMiniportWavePci è l'interfaccia primaria esposta dal driver miniport per un dispositivo audio WavePci.
IMiniportWavePciStream L'interfaccia IMiniportWavePciStream rappresenta il flusso di onda che scorre attraverso un pin su un filtro WavePci.
IMiniportWaveRT L'interfaccia IMiniportWaveRT è l'interfaccia primaria esposta dal driver miniport per un dispositivo audio WaveRT.
IMiniportWaveRTInputStream L'interfaccia IMiniportWaveRTInputStream rappresenta il flusso dell'onda di input che scorre attraverso un pin nel filtro KS che esegue il wrapping di un dispositivo waveRT o di acquisizione. IMiniportWaveRTInputStream eredita dall'interfaccia IUnknown.
IMiniportWaveRTOutputStream L'interfaccia IMiniportWaveRTOutputStream rappresenta il flusso dell'onda di output. IMiniportWaveRTOutputStream eredita dall'interfaccia IUnknown.
IMiniportWaveRTStream L'interfaccia IMiniportWaveRTStream rappresenta il flusso di onda che scorre attraverso un pin nel filtro KS che esegue il wrapping di un rendering o dell'acquisizione di WaveRT.
IMiniportWaveRTStreamNotification L'interfaccia IMiniportWaveRTStreamNotification è supportata in Windows Vista e nei sistemi operativi Windows successivi e aumenta l'interfaccia IMiniportWaveRTStream, fornendo metodi aggiuntivi per facilitare le notifiche degli eventi del driver DMA.
IMusicTechnology L'interfaccia IMusicTechnology viene usata per modificare i GUID della tecnologia musicale specificati nei descrittori dell'intervallo di dati per i pin appartenenti a un driver miniport MIDI o DMus.
IPinCount L'interfaccia IPinCount fornisce un mezzo per il driver miniport per monitorare e modificare il numero di pin in modo dinamico perché i pin vengono creati e chiusi.
IPinName Nei sistemi operativi Windows 7 e versioni successive, l'interfaccia IPinName viene usata dai driver miniport per segnalare e aggiornare i nomi degli endpoint audio.
IPort L'interfaccia IPort è l'interfaccia generica per i driver di porta audio. Tutti i driver di porta audio espongono IPort come parte del bordo inferiore. Il driver dell'adapter chiama il metodo di inizializzazione in questa interfaccia. IPort eredita dall'interfaccia IUnknown.
IPortClsEtwHelper L'interfaccia IPortClsEtwHelper consente a un driver miniport audio di accedere alle funzioni helper di Traccia eventi per Windows (ETW).
IPortClsNotifications Interfaccia implementata dalle porte per fornire helper di notifica a miniport per supportare la comunicazione del modulo audio.
IPortClsPnp IPortClsPnp è l'interfaccia di gestione PnP che il driver della classe di porta (PortCls) espone all'adapter.
IPortClsPower L'interfaccia IPortClsPower è supportata in Windows Vista e versioni successive di Windows. IPortClsPower è l'interfaccia di risparmio energia che il driver della classe di porta (PortCls) espone all'adattatore.
IPortClsRuntimePower IPortClsRuntimePower è l'interfaccia usata dal driver della classe di porta (PortCls) per accedere alle funzionalità di risparmio energia di runtime della scheda audio.
IPortClsStreamResourceManager IPortClsStreamResourceManager viene usato per gestire la registrazione delle risorse di flusso audio.
IPortClsStreamResourceManager2 IPortClsStreamResourceManager2 viene usato per gestire la registrazione delle risorse di flusso audio.
IPortClsVersion L'interfaccia IPortClsVersion viene usata da un driver miniport per identificare la versione del sistema operativo Windows in cui è in esecuzione il driver. Il driver di porta implementa questa interfaccia e la espone al driver miniport.
IPortEvents L'interfaccia IPortEvents viene usata dai driver miniport per notificare ai client eventi hardware.
IPortMidi L'interfaccia IPortMidi è l'interfaccia primaria del driver di porta MIDI.
IPortTopology L'interfaccia IPortTo topologia fornisce il supporto del driver di porta generico a un driver miniport della topologia.
IPortWaveCyclic L'interfaccia IPortWaveCyclic è l'interfaccia primaria del driver di porta WaveCyclic.
IPortWavePci L'interfaccia IPortWavePci è l'interfaccia primaria del driver della porta WavePci.
IPortWavePciStream L'interfaccia IPortWavePciStream è l'interfaccia di callback associata al flusso che fornisce servizi di mapping agli oggetti di flusso miniport WavePci.
IPortWaveRT L'interfaccia IPortWaveRT è supportata in Windows Vista e nei sistemi operativi successivi ed è l'interfaccia principale che il driver della porta WaveRT espone al driver dell'adattatore che implementa l'oggetto driver miniport WaveRT.
IPortWaveRTStream L'interfaccia IPortWaveRTStream è supportata in Windows Vista e nei sistemi operativi successivi ed è un'interfaccia specifica del flusso che fornisce metodi helper da usare dal driver miniport WaveRT.
IPortWMIRegistration L'interfaccia IPortWMIRegistration viene fornita in Windows 7 e versioni successive di Windows. Questa interfaccia consente al driver miniport di coordinare la registrazione di Event Tracing for Windows (ETW) tra PortCls e il driver miniport.
IPowerNotify L'interfaccia IPowerNotify è un'interfaccia facoltativa che i driver miniport possono esporre se richiedono una notifica anticipata delle modifiche dello stato di alimentazione in sospeso.
IPreFetchOffset L'interfaccia IPreFetchOffset controlla l'offset di prefetch, ovvero il numero di byte che separano i cursori di riproduzione e scrittura in un flusso di output DirectSound.
IRegistryKey L'interfaccia IRegistryKey fornisce un'astrazione di una chiave del Registro di sistema che un driver miniport può usare per accedere alla chiave e alle relative sottochiavi.
IResourceList L'interfaccia IResourceList fornisce un'astrazione di un elenco di risorse di configurazione, ovvero un elenco delle risorse hardware di sistema assegnate dal gestore Plug and Play a un dispositivo in fase di avvio.
IServiceGroup L'interfaccia IServiceGroup incapsula un gruppo di oggetti che richiedono la notifica della stessa richiesta di servizio.
IServiceSink L'interfaccia IServiceSink incapsula la gestione di una richiesta di servizio.
IUnregisterPhysicalConnection L'interfaccia IUnregisterPhysicalConnection implementa tre metodi per rimuovere una connessione fisica registrata.
IUnregisterSubdevice L'interfaccia IUnregisterSubdevice implementa un metodo per rimuovere un sottodevice registrato.

Funzioni


PcAddAdapterDevice La funzione PcAddAdapterDevice aggiunge un dispositivo adapter allo stack di dispositivi WDM.
PcAddContentHandlers La funzione PcAddContentHandlers fornisce al sistema un elenco di funzioni che gestiscono il contenuto protetto.
PcAddStreamResource PcAddStreamResource aggiunge una risorsa di flusso.
PcCompleteIrp La funzione PcCompleteIrp completa un'IRP contrassegnata in precedenza come in sospeso.
PcCompletePendingPropertyRequest La funzione PcCompletePendingPropertyRequest viene chiamata per completare una richiesta di proprietà in sospeso.
PcCreateContentMixed La funzione PcCreateContentMixed calcola i diritti di contenuto DRM per un flusso composito contenente contenuto misto da alcuni flussi audio KS.
PcDestroyContent La funzione PcDestroyContent elimina un ID contenuto DRM creato da PcCreateContentMixed. Si noti che questa chiamata di funzione è identica all'operazione della funzione DrmDestroyContent e le definizioni dei parametri e il valore restituito sono identici.
PcDispatchIrp La funzione PcDispatchIrp invia un'IRP al gestore predefinito del driver di sistema PortCls.
PcForwardContentToDeviceObject La funzione PcForwardContentToDeviceObject accetta un oggetto dispositivo che rappresenta un dispositivo a cui il chiamante intende inoltrare contenuto protetto.
PcForwardContentToFileObject La funzione PcForwardContentToFileObject è obsoleta e viene mantenuta solo per supportare i driver esistenti.
PcForwardContentToInterface La funzione PcForwardContentToInterface accetta un puntatore all'interfaccia COM di un oggetto a cui il chiamante intende inoltrare il contenuto protetto.
PcForwardIrpSynchronous La funzione PcForwardIrpSynchronous viene usata dai gestori IRP per inoltrare i provider di integrazione Plug and Play all'oggetto dispositivo fisico (PDO).
PcGetContentRights La funzione PcGetContentRights recupera i diritti di contenuto DRM assegnati a un ID contenuto DRM. Si noti che questa chiamata di funzione è identica all'operazione della funzione DrmGetContentRights e le definizioni dei parametri e il valore restituito sono identici.
PcGetDeviceProperty La funzione PcGetDeviceProperty restituisce la proprietà del dispositivo richiesta dal Registro di sistema.
PcGetPhysicalDeviceObject La funzione PcGetPhysicalDeviceObject consente ai driver miniport audio di recuperare l'oggetto dispositivo fisico sottostante del dispositivo audio.
PcGetTimeInterval La funzione PcGetTimeInterval restituisce il tempo trascorso da un tempo specificato. Il tempo viene misurato in unità da 100 nanosecondi.
PcInitializeAdapterDriver La funzione PcInitializeAdapterDriver associa un driver di adapter al driver di sistema PortCls.
PcNewDmaChannel La funzione PcNewDmaChannel crea un nuovo oggetto DMA-channel. Questa funzione è obsoleta; per altre informazioni, vedere i commenti seguenti.
PcNewInterruptSync La funzione PcNewInterruptSync crea e inizializza un oggetto di sincronizzazione di interruzioni.
PcNewMiniport La funzione PcNewMiniport crea un'istanza di uno dei driver miniport forniti dal sistema incorporati nel driver di sistema PortCls, portcls.sys.
PcNewPort La funzione PcNewPort crea un nuovo oggetto port-driver fornito dal sistema, la cui interfaccia (derivata dalla classe di base IPort) viene specificata da un ID classe.
PcNewRegistryKey La funzione PcNewRegistryKey apre o crea una nuova chiave del Registro di sistema e crea un oggetto IRegistryKey per rappresentare la chiave. Il chiamante accede alla chiave tramite questo oggetto.
PcNewResourceList La funzione PcNewResourceList crea e inizializza un elenco di risorse.
PcNewResourceSublist La funzione PcNewResourceSublist crea e inizializza un elenco di risorse vuoto derivato da un altro elenco di risorse.
PcNewServiceGroup La funzione PcNewServiceGroup crea e inizializza un gruppo di servizi.
PcRegisterAdapterPnpManagement La funzione PcRegisterAdapterPnpManagement registra l'interfaccia di gestione PnP della scheda con il driver di sistema PortCls. Viene usato per supportare il bilanciamento del PnP.
PcRegisterAdapterPowerManagement La funzione PcRegisterAdapterPowerManagement registra l'interfaccia di risparmio energia dell'adattatore con il driver di sistema PortCls.
PcRegisterIoTimeout La funzione PcRegisterIoTimeout registra una routine di callback I/O-timer fornita dal driver per un oggetto dispositivo specificato.
PcRegisterPhysicalConnection La funzione PcRegisterPhysicalConnection registra una connessione fisica tra due filtri adattatori audio creati dallo stesso driver dell'adattatore.
PcRegisterPhysicalConnectionFromExternal La funzione PcRegisterPhysicalConnectionFromExternal registra una connessione fisica a un filtro adattatore audio da un filtro adattatore audio esterno.
PcRegisterPhysicalConnectionToExternal La funzione PcRegisterPhysicalConnectionToExternal registra una connessione fisica da un filtro adattatore audio a un filtro adattatore audio esterno.
PcRegisterSubdevice La funzione PcRegisterSubdevice registra un sottodispositivo per renderlo disponibile per l'uso da parte dei client.
PcRemoveStreamResource PcRemoveStreamResource rimuove una risorsa di flusso esistente.
PcRequestNewPowerState La funzione PcRequestNewPowerState viene usata per richiedere un nuovo stato di alimentazione per il dispositivo. Questa funzione in genere non è necessaria per i driver dell'adattatore, ma talvolta può essere utile per risolvere alcuni tipi di problemi hardware.
PcUnregisterAdapterPnpManagement La funzione PcUnregisterAdapterPnpManagement annulla la registrazione dell'interfaccia di gestione PnP dell'adattatore audio dal driver della classe PortCls. Viene usato per supportare il ribilanciamento PnP.
PcUnregisterAdapterPowerManagement La funzione PcUnregisterAdapterPowerManagement annulla la registrazione dell'interfaccia di risparmio energia dell'adattatore audio dal driver di classe PortCls. La funzione PcUnregisterAdapterPowerManagement è disponibile in Windows 7 e versioni successive di Windows.
PcUnregisterIoTimeout La funzione PcUnregisterIoTimeout annulla la registrazione di una routine di callback I/O-timer fornita dal driver per un oggetto dispositivo specificato.

Funzioni di callback


PCPFNEVENT_HANDLER Una routine EventHandler elabora le richieste di eventi.

Strutture


PCAUTOMATION_TABLE La struttura PCAUTOMATION_TABLE contiene una tabella master del driver miniport di proprietà, metodi ed eventi.
PCEVENT_ITEM La struttura PCEVENT_ITEM viene usata per descrivere un evento supportato da un determinato filtro, pin o nodo.
PCEVENT_REQUEST La struttura PCEVENT_REQUEST specifica una richiesta di evento.
PCFILTER_DESCRIPTOR La struttura PCFILTER_DESCRIPTOR descrive l'implementazione di un driver miniport di un filtro. La struttura specifica i pin, i nodi, le connessioni e le proprietà del filtro.
PCMETHOD_ITEM La struttura PCMETHOD_ITEM descrive un metodo supportato da un filtro, un pin o un nodo.
PCMETHOD_REQUEST La struttura PCMETHOD_REQUEST specifica una richiesta di metodo.
PCNODE_DESCRIPTOR La struttura PCNODE_DESCRIPTOR descrive un nodo nel filtro implementato da un driver miniport della topologia.
PCNOTIFICATION_BUFFER Buffer di notifica usato da IPortClsNotifications.
PCPIN_DESCRIPTOR La struttura PCPIN_DESCRIPTOR descrive una factory di pin.
PCPROPERTY_ITEM La struttura PCPROPERTY_ITEM descrive una proprietà supportata da un determinato filtro, pin o nodo.
PCPROPERTY_REQUEST La struttura PCPROPERTY_REQUEST specifica una richiesta di proprietà.
PCSTREAMRESOURCE_DESCRIPTOR PCSTREAMRESOURCE_DESCRIPTOR definisce la risorsa di flusso. Usare PCSTREAMRESOURCE_DESCRIPTOR_INIT per inizializzare correttamente questa struttura.

Enumerazioni


eChannelTargetType L'enumerazione eChannelTargetType definisce costanti che specificano un tipo di nodo (destinazione) in un determinato canale.
eEngineFormatType L'enumerazione eEngineFormatType definisce costanti che specificano il tipo di dati audio supportato dal motore audio.
EPcMiniportEngineEvent Questo argomento presenta l'enumerazione EPcMiniportEngineEvent e descrive i parametri che forniscono informazioni aggiuntive quando il driver miniport segnala un errore di glitch.
PC_EXIT_LATENCY In questo argomento viene illustrata l'enumerazione PC_EXIT_LATENCY e vengono descritti i relativi membri. I tempi di latenza vengono mappati a orari massimi specifici in cui il dispositivo deve essere in grado di uscire dallo stato di sospensione e di immettere lo stato completamente funzionale (D0).
PC_REBALANCE_TYPE L'enumerazione PC_REBALANCE_TYPE descrive il tipo di supporto per il ribilanciamento.
PcStreamResourceType In questo argomento viene illustrata l'enumerazione PcStreamResourceType e vengono descritti i relativi membri. L'enumerazione PcStreamResourceType viene usata per definire il tipo di risorse usate per flussi audio specifici.

Condividi tramite

intestazione portcls.h

Interfacce

Funzioni

Funzioni di callback

Strutture

Enumerazioni

Commenti e suggerimenti

Risorse aggiuntive