cabeçalho portcls.h

Esse cabeçalho é usado pelo áudio. Para obter mais informações, consulte:

• Áudio

portcls.h contém as seguintes interfaces de programação:

Interfaces

IAdapterPnpManagement IAdapterPnpManagement é uma interface que os adaptadores devem implementar e registrar se quiserem receber mensagens de gerenciamento PnP.
IAdapterPowerManagement A interface IAdapterPowerManagement é usada para gerenciar o estado de energia de um adaptador de áudio.
IAdapterPowerManagement2 A interface IAdapterPowerManagement2 herda do IUnknown e é usada para gerenciar o estado de energia de um adaptador de áudio.
IAdapterPowerManagement3 A interface IAdapterPowerManagement3 herda do IUnknown e é usada para receber mensagens de gerenciamento de energia.
IDmaChannel A interface IDmaChannel fornece uma abstração de um canal DMA e seus parâmetros de uso e buffer de DMA associados.
IDmaChannelSlave A interface IDmaChannelSlave fornece métodos para monitorar e controlar um canal DMA para um dispositivo subordinado (conforme descrito em Introdução aos Objetos do Adaptador).
IDrmPort A interface IDrmPort é usada por um driver de miniporto WaveCyclic ou WavePci para gerenciar o conteúdo protegido por DRM (consulte Gerenciamento de Direitos Digitais).
IDrmPort2 A interface IDrmPort2 é usada por um driver de miniporto WaveCyclic ou WavePci para gerenciar o conteúdo protegido por DRM (consulte Gerenciamento de Direitos Digitais).
IInterruptSync A interface IInterruptSync representa um objeto de sincronização de interrupção que sincroniza a execução de uma lista de ISRs (rotinas de serviço de interrupção) com rotinas não ISR.
IMiniport A interface IMiniport é a interface de miniporto genérica compatível com todos os objetos de miniport. IMiniport herda da interface IUnknown.
IMiniportAudioEngineNode Essa interface permite que um driver de miniporte use propriedades KS que acessam o mecanismo de áudio por meio de um identificador de filtro KS.
IMiniportAudioSignalProcessing A interface IMiniportAudioSignalProcessing é implementada pelo componente de miniporto WaveRT de qualquer driver de áudio, se qualquer um de seus pinos der suporte a modos de processamento de sinal de áudio.
IMiniportMidi A interface IMiniportMidi é a interface primária de um driver de miniporto MIDI para um dispositivo sintetizador MIDI.
IMiniportMidiStream A interface IMiniportMidiStream representa o fluxo MIDI que flui por meio de um pino em um filtro MIDI.
IMiniportPnpNotify IMiniportPnpNotify é uma interface opcional para permitir que objetos de miniport (subdispositivos de áudio) recebam notificações de alteração de estado PnP.
IMiniportStreamAudioEngineNode Essa interface permite que um driver de miniporte use propriedades KS que acessam o mecanismo de áudio por meio de um identificador de instância de pino.
IMiniportStreamAudioEngineNode2 A interface IMiniportStreamAudioEngineNode2 permite que um driver de miniporto de áudio estenda os recursos da interface IMiniportStreamAudioEngineNode.
IMiniportTopology A interface IMiniportTopology é a interface primária de um driver de miniporto de topologia.
IMiniportWaveCyclic A interface IMiniportWaveCyclic é a interface primária exposta pelo driver de miniporto para um dispositivo de áudio WaveCyclic.
IMiniportWaveCyclicStream A interface IMiniportWaveCyclicStream representa o fluxo de onda que flui através de um pino em um filtro WaveCyclic.
IMiniportWavePci A interface IMiniportWavePci é a interface primária exposta pelo driver de miniporto para um dispositivo de áudio WavePci.
IMiniportWavePciStream A interface IMiniportWavePciStream representa o fluxo de onda que flui por meio de um pino em um filtro WavePci.
IMiniportWaveRT A interface IMiniportWaveRT é a interface primária exposta pelo driver de miniporto para um dispositivo de áudio WaveRT.
IMiniportWaveRTInputStream A interface IMiniportWaveRTInputStream representa o fluxo de onda de entrada que flui por meio de um pino no filtro KS que encapsula um dispositivo de renderização ou captura WaveRT. IMiniportWaveRTInputStream herda da interface IUnknown.
IMiniportWaveRTOutputStream A interface IMiniportWaveRTOutputStream representa o fluxo de onda de saída. IMiniportWaveRTOutputStream herda da interface IUnknown.
IMiniportWaveRTStream A interface IMiniportWaveRTStream representa o fluxo de onda que flui por meio de um pino no filtro KS que encapsula um dispositivo de renderização ou captura WaveRT.
IMiniportWaveRTStreamNotification A interface IMiniportWaveRTStreamNotification tem suporte nos sistemas operacionais Windows Vista e posteriores do Windows e aumenta a interface IMiniportWaveRTStream, fornecendo métodos adicionais para facilitar as notificações de eventos do driver DMA.
IMusicTechnology A interface IMusicTechnology é usada para alterar os GUIDs de tecnologia de música especificados nos descritores do intervalo de dados para os pinos que pertencem a um driver de miniporto MIDI ou DMus.
IPinCount A interface IPinCount fornece um meio para o driver de miniporto monitorar e manipular suas contagens de pinos dinamicamente à medida que os pinos são instanciados e fechados.
IPinName No Windows 7 e em sistemas operacionais posteriores, a interface IPinName é usada por drivers de miniporto para relatar e atualizar os nomes dos pontos de extremidade de áudio.
Iport A interface IPort é a interface genérica para drivers de porta de áudio. Todos os drivers de porta de áudio expõem iPort como parte de sua borda inferior. O driver do adaptador chama o método de inicialização nessa interface. IPort herda da interface IUnknown.
IPortClsEtwHelper A interface IPortClsEtwHelper permite que um driver de miniporto de áudio acesse as funções auxiliares do ETW (Rastreamento de Eventos para Windows).
IPortClsNotifications Uma interface implementada por portas para fornecer auxiliares de notificação a miniportes para dar suporte à comunicação do módulo de áudio.
IPortClsPnp IPortClsPnp é a interface de gerenciamento PnP que o driver de classe de porta (PortCls) expõe ao adaptador.
IPortClsPower A interface IPortClsPower tem suporte no Windows Vista e em versões posteriores do Windows. IPortClsPower é a interface de gerenciamento de energia que o driver de classe de porta (PortCls) expõe ao adaptador.
IPortClsRuntimePower IPortClsRuntimePower é a interface que o driver de classe de porta (PortCls) usa para acessar os recursos de gerenciamento de energia de runtime do adaptador de áudio.
IPortClsStreamResourceManager IPortClsStreamResourceManager é usado para gerenciar o registro de recursos de fluxo de áudio.
IPortClsStreamResourceManager2 IPortClsStreamResourceManager2 é usado para gerenciar o registro de recursos de fluxo de áudio.
IPortClsVersion A interface IPortClsVersion é usada por um driver de miniporto para identificar a versão do sistema operacional Windows em que o driver está sendo executado. O driver de porta implementa essa interface e a expõe ao driver de miniport.
IPortEvents A interface IPortEvents é usada por drivers de miniport para notificar os clientes sobre eventos de hardware.
IPortMidi A interface IPortMidi é a interface primária do driver de porta MIDI.
IPortTopology A interface IPortTopology fornece suporte genérico ao driver de porta para um driver de miniporto de topologia.
IPortWaveCyclic A interface IPortWaveCyclic é a interface principal do driver de porta WaveCyclic.
IPortWavePci A interface IPortWavePci é a interface principal do driver de porta WavePci.
IPortWavePciStream A interface IPortWavePciStream é a interface de retorno de chamada associada ao fluxo que fornece serviços de mapeamento para objetos de fluxo de miniporto WavePci.
IPortWaveRT A interface IPortWaveRT tem suporte no Windows Vista e em sistemas operacionais posteriores e é a interface main que o driver de porta WaveRT expõe ao driver do adaptador que implementa o objeto do driver de miniporto WaveRT.
IPortWaveRTStream A interface IPortWaveRTStream tem suporte no Windows Vista e em sistemas operacionais posteriores e é uma interface específica de fluxo que fornece métodos auxiliares para uso pelo driver de miniporto WaveRT.
IPortWMIRegistration A interface IPortWMIRegistration é fornecida no Windows 7 e versões posteriores do Windows. Essa interface permite que o driver de miniporte coordene o registro de ETW (Rastreamento de Eventos para Windows) entre PortCls e o driver de miniport.
IPowerNotify A interface IPowerNotify é uma interface opcional que os drivers de miniporto podem expor se precisarem de notificação antecipada de alterações iminentes de estado de energia.
IPreFetchOffset A interface IPreFetchOffset controla o deslocamento de pré-busca, que é o número de bytes que separam os cursores de reprodução e gravação em um fluxo de saída DirectSound.
IRegistryKey A interface IRegistryKey fornece uma abstração de uma chave do Registro que um driver de miniporto pode usar para acessar a chave e suas subchaves.
IResourceList A interface IResourceList fornece uma abstração de uma lista de recursos de configuração, que é uma lista dos recursos de hardware do sistema que o Gerenciador de Plug and Play atribui a um dispositivo no momento da inicialização.
IServiceGroup A interface IServiceGroup encapsula um grupo de objetos que exigem notificação da mesma solicitação de serviço.
IServiceSink A interface IServiceSink encapsula o tratamento de uma solicitação de serviço.
IUnregisterPhysicalConnection A interface IUnregisterPhysicalConnection implementa três métodos para remover uma conexão física registrada.
IUnregisterSubdevice A interface IUnregisterSubdevice implementa um método para remover um subdispositivo registrado.

Funções

PcAddAdapterDevice A função PcAddAdapterDevice adiciona um dispositivo adaptador à pilha de dispositivos WDM.
PcAddContentHandlers A função PcAddContentHandlers fornece ao sistema uma lista de funções que lidam com conteúdo protegido.
PcAddStreamResource PcAddStreamResource adiciona um recurso de fluxo.
PcCompleteIrp A função PcCompleteIrp conclui um IRP que foi marcado anteriormente como pendente.
PcCompletePendingPropertyRequest A função PcCompletePendingPropertyRequest é chamada para concluir uma solicitação de propriedade pendente.
PcCreateContentMixed A função PcCreateContentMixed calcula os direitos de conteúdo DRM para um fluxo composto que contém conteúdo misto de alguns fluxos de áudio KS.
PcDestroyContent A função PcDestroyContent exclui uma ID de conteúdo DRM que foi criada por PcCreateContentMixed. Observe que essa chamada de função é idêntica na operação à função DrmDestroyContent e suas definições de parâmetro e valor retornado também são idênticas.
PcDispatchIrp A função PcDispatchIrp envia um IRP para o manipulador padrão do driver do sistema PortCls.
PcForwardContentToDeviceObject A função PcForwardContentToDeviceObject aceita um objeto de dispositivo que representa um dispositivo para o qual o chamador pretende encaminhar conteúdo protegido.
PcForwardContentToFileObject A função PcForwardContentToFileObject é obsoleta e é mantida apenas para dar suporte a drivers existentes.
PcForwardContentToInterface A função PcForwardContentToInterface aceita um ponteiro para a interface COM de um objeto para o qual o chamador pretende encaminhar o conteúdo protegido.
PcForwardIrpSynchronous A função PcForwardIrpSynchronous é usada por manipuladores IRP para encaminhar IRPs plug e play para o PDO (objeto de dispositivo físico).
PcGetContentRights A função PcGetContentRights recupera os direitos de conteúdo DRM atribuídos a uma ID de conteúdo drm. Observe que essa chamada de função é idêntica na operação à função DrmGetContentRights e suas definições de parâmetro e valor retornado também são idênticas.
PcGetDeviceProperty A função PcGetDeviceProperty retorna a propriedade de dispositivo solicitada do registro.
PcGetPhysicalDeviceObject A função PcGetPhysicalDeviceObject permite que os drivers de miniporto de áudio recuperem o objeto de dispositivo físico subjacente do dispositivo de áudio.
PcGetTimeInterval A função PcGetTimeInterval retorna o tempo decorrido desde um horário especificado. O tempo é medido em unidades de 100 nanossegundos.
PcInitializeAdapterDriver A função PcInitializeAdapterDriver associa um driver de adaptador ao driver do sistema PortCls.
PcNewDmaChannel A função PcNewDmaChannel cria um novo objeto de canal DMA. Essa função está obsoleta; para obter mais informações, consulte os comentários a seguir.
PcNewInterruptSync A função PcNewInterruptSync cria e inicializa um objeto de sincronização de interrupção.
PcNewMiniport A função PcNewMiniport cria uma instância de um dos drivers de miniporto fornecidos pelo sistema que são integrados ao driver do sistema PortCls, portcls.sys.
PcNewPort A função PcNewPort cria um novo objeto de driver de porta fornecido pelo sistema, cuja interface (derivada da classe base IPort) é especificada por uma ID de classe.
PcNewRegistryKey A função PcNewRegistryKey abre ou cria uma nova chave do Registro e cria um objeto IRegistryKey para representar a chave. O chamador acessa a chave por meio desse objeto.
PcNewResourceList A função PcNewResourceList cria e inicializa uma lista de recursos.
PcNewResourceSublist A função PcNewResourceSublist cria e inicializa uma lista de recursos vazia derivada de outra lista de recursos.
PcNewServiceGroup A função PcNewServiceGroup cria e inicializa um grupo de serviços.
PcRegisterAdapterPnpManagement A função PcRegisterAdapterPnpManagement registra a interface de gerenciamento PnP do adaptador com o driver do sistema PortCls. Ele é usado para dar suporte ao reequilíbrio PnP.
PcRegisterAdapterPowerManagement A função PcRegisterAdapterPowerManagement registra a interface de gerenciamento de energia do adaptador com o driver do sistema PortCls.
PcRegisterIoTimeout A função PcRegisterIoTimeout registra uma rotina de retorno de chamada de E/S fornecida pelo driver para um objeto de dispositivo especificado.
PcRegisterPhysicalConnection A função PcRegisterPhysicalConnection registra uma conexão física entre dois filtros de adaptador de áudio instanciados pelo mesmo driver de adaptador.
PcRegisterPhysicalConnectionFromExternal A função PcRegisterPhysicalConnectionFromExternal registra uma conexão física com um filtro de adaptador de áudio de um filtro de adaptador de áudio externo.
PcRegisterPhysicalConnectionToExternal A função PcRegisterPhysicalConnectionToExternal registra uma conexão física de um filtro de adaptador de áudio para um filtro de adaptador de áudio externo.
PcRegisterSubdevice A função PcRegisterSubdevice registra um subdispositivo para disponibilizá-lo para uso por clientes.
PcRemoveStreamResource PcRemoveStreamResource remove um recurso de fluxo existente.
PcRequestNewPowerState A função PcRequestNewPowerState é usada para solicitar um novo estado de energia para o dispositivo. Essa função normalmente não é necessária para drivers de adaptador, mas ocasionalmente pode ser útil para contornar alguns tipos de problemas de hardware.
PcUnregisterAdapterPnpManagement A função PcUnregisterAdapterPnpManagement cancela o registro da interface de gerenciamento PnP do adaptador de áudio do driver de classe PortCls. Ele é usado para dar suporte ao reequilíbrio PnP.
PcUnregisterAdapterPowerManagement A função PcUnregisterAdapterPowerManagement cancela o registro da interface de gerenciamento de energia do adaptador de áudio do driver de classe PortCls. A função PcUnregisterAdapterPowerManagement está disponível no Windows 7 e versões posteriores do Windows.
PcUnregisterIoTimeout A função PcUnregisterIoTimeout cancela o registro de uma rotina de retorno de chamada de E/S fornecida pelo driver para um objeto de dispositivo especificado.

Funções de retorno de chamada

PCPFNEVENT_HANDLER Uma rotina EventHandler processa solicitações de evento.

Estruturas

PCAUTOMATION_TABLE A estrutura PCAUTOMATION_TABLE contém o master tabela de propriedades, métodos e eventos de um driver de miniport.
PCEVENT_ITEM A estrutura PCEVENT_ITEM é usada para descrever um evento com suporte por um filtro, pino ou nó específico.
PCEVENT_REQUEST A estrutura PCEVENT_REQUEST especifica uma solicitação de evento.
PCFILTER_DESCRIPTOR A estrutura PCFILTER_DESCRIPTOR descreve a implementação de um filtro por um driver de miniport. A estrutura especifica os pinos, os nós, as conexões e as propriedades do filtro.
PCMETHOD_ITEM A estrutura PCMETHOD_ITEM descreve um método com suporte por um filtro, pino ou nó.
PCMETHOD_REQUEST A estrutura PCMETHOD_REQUEST especifica uma solicitação de método.
PCNODE_DESCRIPTOR A estrutura PCNODE_DESCRIPTOR descreve um nó no filtro que um driver de miniporto de topologia implementa.
PCNOTIFICATION_BUFFER O buffer de notificação usado por IPortClsNotifications.
PCPIN_DESCRIPTOR A estrutura PCPIN_DESCRIPTOR descreve uma fábrica de pinos.
PCPROPERTY_ITEM A estrutura PCPROPERTY_ITEM descreve uma propriedade compatível com um filtro, pino ou nó específico.
PCPROPERTY_REQUEST A estrutura PCPROPERTY_REQUEST especifica uma solicitação de propriedade.
PCSTREAMRESOURCE_DESCRIPTOR PCSTREAMRESOURCE_DESCRIPTOR define o recurso de fluxo. Use PCSTREAMRESOURCE_DESCRIPTOR_INIT para inicializar corretamente essa estrutura.

Enumerações

eChannelTargetType A enumeração eChannelTargetType define constantes que especificam um tipo de nó (destino) em um determinado canal.
eEngineFormatType A enumeração eEngineFormatType define constantes que especificam o tipo de dados de áudio compatível com o mecanismo de áudio.
EPcMiniportEngineEvent Este tópico apresenta a enumeração EPcMiniportEngineEvent e descreve os parâmetros que fornecem informações adicionais quando o driver de miniporto relata um erro de falha.
PC_EXIT_LATENCY Este tópico discute a enumeração PC_EXIT_LATENCY e descreve seus membros. Os tempos de latência são mapeados para tempos máximos específicos em que o dispositivo deve ser capaz de sair do estado de suspensão e inserir o estado totalmente funcional (D0).
PC_REBALANCE_TYPE A enumeração PC_REBALANCE_TYPE descreve o tipo de suporte para rebalanceamento.
PcStreamResourceType Este tópico discute a enumeração PcStreamResourceType e descreve seus membros. A enumeração PcStreamResourceType é usada para definir o tipo de recursos usados para streaming de áudio específico.