encabezado portcls.h

Este encabezado lo usa el audio. Para más información, consulte:

• Audio

portcls.h contiene las siguientes interfaces de programación:

Interfaces

IAdapterPnpManagement IAdapterPnpManagement es una interfaz que los adaptadores deben implementar y registrar si quieren recibir mensajes de administración de PnP.
IAdapterPowerManagement La interfaz IAdapterPowerManagement se usa para administrar el estado de alimentación de un adaptador de audio.
IAdapterPowerManagement2 La interfaz IAdapterPowerManagement2 hereda de IUnknown y se usa para administrar el estado de alimentación de un adaptador de audio.
IAdapterPowerManagement3 La interfaz IAdapterPowerManagement3 hereda de IUnknown y se usa para recibir mensajes de administración de energía.
IDmaChannel La interfaz IDmaChannel proporciona una abstracción de un canal DMA y sus parámetros de uso y búfer DMA asociados.
IDmaChannelSlave La interfaz IDmaChannelSlave proporciona métodos para supervisar y controlar un canal DMA para un dispositivo subordinado (como se describe en Introducción a los objetos de adaptador).
IDrmPort La interfaz IDrmPort se usa mediante un controlador de miniporte WaveCíclico o WavePci para administrar el contenido protegido por DRM (consulte Digital Rights Management).
IDrmPort2 La interfaz IDrmPort2 la usa un controlador de miniporte WaveCíclico o WavePci para administrar el contenido protegido por DRM (consulte Digital Rights Management).
IInterruptSync La interfaz IInterruptSync representa un objeto de sincronización de interrupciones que sincroniza la ejecución de una lista de rutinas de servicio de interrupción (ISR) con rutinas que no son ISR.
IMiniport La interfaz IMiniport es la interfaz miniport genérica que admiten todos los objetos miniport. IMiniport hereda de la interfaz IUnknown.
IMiniportAudioEngineNode Esta interfaz permite que un controlador de miniporte use propiedades KS que acceden al motor de audio a través de un controlador de filtro KS.
IMiniportAudioSignalProcessing La interfaz IMiniportAudioSignalProcessing se implementa mediante el componente miniporte WaveRT de cualquier controlador de audio, si alguno de sus patillas admite modos de procesamiento de señal de audio.
IMiniportMidi La interfaz IMiniportMidi es la interfaz principal de un controlador de minipuerto MIDI para un dispositivo de sintetizador MIDI.
IMiniportMidiStream La interfaz IMiniportMidiStream representa la secuencia MIDI que fluye a través de un pin en un filtro MIDI.
IMiniportPnpNotify IMiniportPnpNotify es una interfaz opcional para permitir que los objetos miniport (subdispositivos de audio) reciban notificaciones de cambio de estado PnP.
IMiniportStreamAudioEngineNode Esta interfaz permite que un controlador de miniporte use propiedades KS que acceden al motor de audio a través de un identificador de instancia de patilla.
IMiniportStreamAudioEngineNode2 La interfaz IMiniportStreamAudioEngineNode2 permite que un controlador de miniporte de audio amplíe las funcionalidades de la interfaz IMiniportStreamAudioEngineNode.
IMiniportTopology La interfaz IMiniportTopology es la interfaz principal de un controlador de miniporte de topología.
IMiniportWaveCíclico La interfaz IMiniportWaveCíclica es la interfaz principal expuesta por el controlador de minipuerto para un dispositivo de audio WaveCíclico.
IMiniportWaveCíclicaStream La interfaz IMiniportWaveCyclicStream representa la secuencia de onda que fluye a través de un pin en un filtro WaveCíclico.
IMiniportWavePci La interfaz IMiniportWavePci es la interfaz principal expuesta por el controlador de miniport para un dispositivo de audio WavePci.
IMiniportWavePciStream La interfaz IMiniportWavePciStream representa la secuencia de onda que fluye a través de un pin en un filtro WavePci.
IMiniportWaveRT La interfaz IMiniportWaveRT es la interfaz principal expuesta por el controlador de minipuerto para un dispositivo de audio WaveRT.
IMiniportWaveRTInputStream La interfaz IMiniportWaveRTInputStream representa la secuencia de onda de entrada que fluye a través de un pin en el filtro KS que encapsula un dispositivo de captura o representación de WaveRT. IMiniportWaveRTInputStream hereda de la interfaz IUnknown.
IMiniportWaveRTOutputStream La interfaz IMiniportWaveRTOutputStream representa el flujo de onda de salida. IMiniportWaveRTOutputStream hereda de la interfaz IUnknown.
IMiniportWaveRTStream La interfaz IMiniportWaveRTStream representa la secuencia de onda que fluye a través de un pin en el filtro KS que encapsula un dispositivo de captura o representación de WaveRT.
IMiniportWaveRTStreamNotification La interfaz IMiniportWaveRTStreamNotification se admite en Windows Vista y versiones posteriores sistemas operativos Windows, y aumenta la interfaz IMiniportWaveRTStream, lo que proporciona métodos adicionales para facilitar las notificaciones de eventos del controlador DMA.
IMusicTechnology La interfaz IMusicTechnology se utiliza para cambiar los GUID de tecnología de música que se especifican en los descriptores de rango de datos para los patillas que pertenecen a un controlador de miniporte MIDI o DMus.
IPinCount La interfaz IPinCount proporciona un medio para que el controlador de miniporte supervise y manipule sus recuentos de patillas dinámicamente a medida que se crean instancias y se cierran.
IPinName En los sistemas operativos Windows 7 y versiones posteriores, los controladores de miniporte usan la interfaz IPinName para informar y actualizar los nombres de los puntos de conexión de audio.
IPort La interfaz IPort es la interfaz genérica para los controladores de puerto de audio. Todos los controladores de puerto de audio exponen IPort como parte de su borde inferior. El controlador del adaptador llama al método de inicialización en esta interfaz. IPort hereda de la interfaz IUnknown.
IPortClsEtwHelper La interfaz IPortClsEtwHelper permite que un controlador de miniporte de audio acceda a las funciones auxiliares seguimiento de eventos para Windows (ETW).
IPortClsNotifications Interfaz implementada por puertos para proporcionar asistentes de notificación a miniportes para admitir la comunicación de módulos de audio.
IPortClsPnp IPortClsPnp es la interfaz de administración de PnP que el controlador de clase de puerto (PortCls) expone al adaptador.
IPortClsPower La interfaz IPortClsPower se admite en Windows Vista y versiones posteriores de Windows. IPortClsPower es la interfaz de administración de energía que el controlador de clase de puerto (PortCls) expone al adaptador.
IPortClsRuntimePower IPortClsRuntimePower es la interfaz que usa el controlador de clase de puerto (PortCls) para acceder a las funcionalidades de administración de energía en tiempo de ejecución del adaptador de audio.
IPortClsStreamResourceManager IPortClsStreamResourceManager se usa para administrar el registro de recursos de secuencia de audio.
IPortClsStreamResourceManager2 IPortClsStreamResourceManager2 se usa para administrar el registro de recursos de secuencia de audio.
IPortClsVersion La interfaz IPortClsVersion la usa un controlador de miniporte para identificar la versión del sistema operativo Windows en el que se ejecuta el controlador. El controlador de puerto implementa esta interfaz y la expone al controlador de minipuerto.
IPortEvents Los controladores de miniporto usan la interfaz IPortEvents para notificar a los clientes los eventos de hardware.
IPortMidi La interfaz IPortMidi es la interfaz principal del controlador de puerto MIDI.
IPortTopology La interfaz IPortTopology proporciona compatibilidad del controlador de puerto genérico con un controlador de minipuerto de topología.
IPortWaveCíclico La interfaz IPortWaveCíclica es la interfaz principal del controlador de puerto WaveCíclico.
IPortWavePci La interfaz IPortWavePci es la interfaz principal del controlador de puerto WavePci.
IPortWavePciStream La interfaz IPortWavePciStream es la interfaz de devolución de llamada asociada a la secuencia que proporciona servicios de asignación a objetos de secuencia de miniport de WavePci.
IPortWaveRT La interfaz IPortWaveRT se admite en Windows Vista y sistemas operativos posteriores y es la interfaz principal que el controlador de puerto WaveRT expone al controlador del adaptador que implementa el objeto de controlador de miniporte de WaveRT.
IPortWaveRTStream La interfaz IPortWaveRTStream se admite en Windows Vista y sistemas operativos posteriores, y es una interfaz específica de la secuencia que proporciona métodos auxiliares para su uso por parte del controlador de miniport de WaveRT.
IPortWMIRegistration La interfaz IPortWMIRegistration se proporciona en Windows 7 y versiones posteriores de Windows. Esta interfaz permite al controlador de miniportar coordinar el registro del seguimiento de eventos para Windows (ETW) entre PortCls y el controlador de miniport.
IPowerNotify La interfaz IPowerNotify es una interfaz opcional que los controladores de minipuerto pueden exponer si requieren una notificación anticipada de cambios de estado de energía inminentes.
IPreFetchOffset La interfaz IPreFetchOffset controla el desplazamiento de captura previa, que es el número de bytes que separan los cursores de reproducción y escritura en un flujo de salida de DirectSound.
IRegistryKey La interfaz IRegistryKey proporciona una abstracción de una clave del Registro que un controlador de miniporte puede usar para acceder a la clave y sus subclaves.
IResourceList La interfaz IResourceList proporciona una abstracción de una lista de recursos de configuración, que es una lista de los recursos de hardware del sistema que el administrador de Plug and Play asigna a un dispositivo en el momento de inicio.
IServiceGroup La interfaz IServiceGroup encapsula un grupo de objetos que requieren notificación de la misma solicitud de servicio.
IServiceSink La interfaz IServiceSink encapsula el control de una solicitud de servicio.
IUnregisterPhysicalConnection La interfaz IUnregisterPhysicalConnection implementa tres métodos para quitar una conexión física registrada.
IUnregisterSubdevice La interfaz IUnregisterSubdevice implementa un método para quitar un subdispositivo registrado.

Functions

PcAddAdapterDevice La función PcAddAdapterDevice agrega un dispositivo adaptador a la pila de dispositivos WDM.
PcAddContentHandlers La función PcAddContentHandlers proporciona al sistema una lista de funciones que controlan el contenido protegido.
PcAddStreamResource PcAddStreamResource agrega un recurso de secuencia.
PcCompleteIrp La función PcCompleteIrp completa un IRP que se marcó previamente como pendiente.
PcCompletePendingPropertyRequest Se llama a la función PcCompletePendingPropertyRequest para completar una solicitud de propiedad pendiente.
PcCreateContentMixed La función PcCreateContentMixed calcula los derechos de contenido drm de una secuencia compuesta que contiene contenido mixto de algún número de secuencias de audio KS.
PcDestroyContent La función PcDestroyContent elimina un identificador de contenido DRM creado por PcCreateContentMixed. Tenga en cuenta que esta llamada de función es idéntica en funcionamiento a la función DrmDestroyContent, y sus definiciones de parámetros y valor devuelto también son idénticas.
PcDispatchIrp La función PcDispatchIrp envía un IRP al controlador predeterminado del controlador del sistema PortCls.
PcForwardContentToDeviceObject La función PcForwardContentToDeviceObject acepta un objeto de dispositivo que representa un dispositivo al que el autor de la llamada pretende reenviar contenido protegido.
PcForwardContentToFileObject La función PcForwardContentToFileObject está obsoleta y solo se mantiene para admitir controladores existentes.
PcForwardContentToInterface La función PcForwardContentToInterface acepta un puntero a la interfaz COM de un objeto al que el autor de la llamada pretende reenviar contenido protegido.
PcForwardIrpSynchronous Los controladores IRP usan la función PcForwardIrpSynchronous para reenviar IRP Plug and Play al objeto de dispositivo físico (PDO).
PcGetContentRights La función PcGetContentRights recupera los derechos de contenido drm asignados a un identificador de contenido DRM. Tenga en cuenta que esta llamada de función es idéntica en funcionamiento a la función DrmGetContentRights, y sus definiciones de parámetros y valor devuelto también son idénticos.
PcGetDeviceProperty La función PcGetDeviceProperty devuelve la propiedad de dispositivo solicitada del registro.
PcGetPhysicalDeviceObject La función PcGetPhysicalDeviceObject permite que los controladores de miniporte de audio recuperen el objeto de dispositivo físico subyacente del dispositivo de audio.
PcGetTimeInterval La función PcGetTimeInterval devuelve el tiempo transcurrido desde una hora especificada. El tiempo se mide en unidades de 100 nanosegundos.
PcInitializeAdapterDriver La función PcInitializeAdapterDriver enlaza un controlador de adaptador al controlador del sistema PortCls.
PcNewDmaChannel La función PcNewDmaChannel crea un nuevo objeto de canal DMA. Esta función está obsoleta; para obtener más información, vea los comentarios siguientes.
PcNewInterruptSync La función PcNewInterruptSync crea e inicializa un objeto de sincronización de interrupciones.
PcNewMiniport La función PcNewMiniport crea una instancia de uno de los controladores de miniporte proporcionados por el sistema integrados en el controlador del sistema PortCls, portcls.sys.
PcNewPort La función PcNewPort crea un nuevo objeto port-driver proporcionado por el sistema, cuya interfaz (derivada de la clase base IPort) se especifica mediante un identificador de clase.
PcNewRegistryKey La función PcNewRegistryKey abre o crea una nueva clave del Registro y crea un objeto IRegistryKey para representar la clave. El autor de la llamada accede a la clave a través de este objeto .
PcNewResourceList La función PcNewResourceList crea e inicializa una lista de recursos.
PcNewResourceSublist La función PcNewResourceSublist crea e inicializa una lista de recursos vacía derivada de otra lista de recursos.
PcNewServiceGroup La función PcNewServiceGroup crea e inicializa un grupo de servicios.
PcRegisterAdapterPnpManagement La función PcRegisterAdapterPnpManagement registra la interfaz de administración PnP del adaptador con el controlador del sistema PortCls. Se usa para admitir el reequilibrio de PnP.
PcRegisterAdapterPowerManagement La función PcRegisterAdapterPowerManagement registra la interfaz de administración de energía del adaptador con el controlador del sistema PortCls.
PcRegisterIoTimeout La función PcRegisterIoTimeout registra una rutina de devolución de llamada de temporizador de E/S proporcionada por el controlador para un objeto de dispositivo especificado.
PcRegisterPhysicalConnection La función PcRegisterPhysicalConnection registra una conexión física entre dos filtros de adaptador de audio creados por el mismo controlador de adaptador.
PcRegisterPhysicalConnectionFromExternal La función PcRegisterPhysicalConnectionFromExternal registra una conexión física a un filtro de adaptador de audio desde un filtro de adaptador de audio externo.
PcRegisterPhysicalConnectionToExternal La función PcRegisterPhysicalConnectionToExternal registra una conexión física desde un filtro de adaptador de audio a un filtro de adaptador de audio externo.
PcRegisterSubdevice La función PcRegisterSubdevice registra un subdispositivo para que esté disponible para su uso por parte de los clientes.
PcRemoveStreamResource PcRemoveStreamResource quita un recurso de flujo existente.
PcRequestNewPowerState La función PcRequestNewPowerState se usa para solicitar un nuevo estado de alimentación para el dispositivo. Normalmente, esta función no es necesaria para los controladores del adaptador, pero ocasionalmente puede ser útil para solucionar algunos tipos de problemas de hardware.
PcUnregisterAdapterPnpManagement La función PcUnregisterAdapterPnpManagement anula el registro de la interfaz de administración PnP del adaptador de audio del controlador de clase PortCls. Se usa para admitir el reequilibrio de PnP.
PcUnregisterAdapterPowerManagement La función PcUnregisterAdapterPowerManagement anula el registro de la interfaz de administración de energía del adaptador de audio del controlador de clase PortCls. La función PcUnregisterAdapterPowerManagement está disponible en Windows 7 y versiones posteriores de Windows.
PcUnregisterIoTimeout La función PcUnregisterIoTimeout anula el registro de una rutina de devolución de llamada de temporizador de E/S proporcionada por el controlador para un objeto de dispositivo especificado.

Funciones de devolución de llamada

PCPFNEVENT_HANDLER Una rutina EventHandler procesa las solicitudes de eventos.

Estructuras

PCAUTOMATION_TABLE La estructura de PCAUTOMATION_TABLE contiene una tabla maestra del controlador de miniporte de propiedades, métodos y eventos.
PCEVENT_ITEM La estructura PCEVENT_ITEM se usa para describir un evento compatible con un filtro, un pin o un nodo determinados.
PCEVENT_REQUEST La estructura PCEVENT_REQUEST especifica una solicitud de evento.
PCFILTER_DESCRIPTOR La estructura PCFILTER_DESCRIPTOR describe la implementación de un controlador de minipuerto de un filtro. La estructura especifica las patillas, los nodos, las conexiones y las propiedades del filtro.
PCMETHOD_ITEM La estructura PCMETHOD_ITEM describe un método admitido por un filtro, un pin o un nodo.
PCMETHOD_REQUEST La estructura PCMETHOD_REQUEST especifica una solicitud de método.
PCNODE_DESCRIPTOR La estructura PCNODE_DESCRIPTOR describe un nodo en el filtro que implementa un controlador de miniporte de topología.
PCNOTIFICATION_BUFFER Búfer de notificación usado por IPortClsNotifications.
PCPIN_DESCRIPTOR La estructura de PCPIN_DESCRIPTOR describe un generador de patillas.
PCPROPERTY_ITEM La estructura PCPROPERTY_ITEM describe una propiedad compatible con un filtro, un pin o un nodo determinados.
PCPROPERTY_REQUEST La estructura PCPROPERTY_REQUEST especifica una solicitud de propiedad.
PCSTREAMRESOURCE_DESCRIPTOR PCSTREAMRESOURCE_DESCRIPTOR define el recurso de flujo. Use PCSTREAMRESOURCE_DESCRIPTOR_INIT para inicializar correctamente esta estructura.

Enumeraciones

eChannelTargetType La enumeración eChannelTargetType define constantes que especifican un tipo de nodo (destino) en un canal determinado.
eEngineFormatType La enumeración eEngineFormatType define constantes que especifican el tipo de datos de audio admitido por el motor de audio.
EPcMiniportEngineEvent En este tema se presenta la enumeración EPcMiniportEngineEvent y se describen los parámetros que proporcionan información adicional cuando el controlador de miniporte notifica un error de brillo.
PC_EXIT_LATENCY En este tema se describe el PC_EXIT_LATENCY enumeración y se describen sus miembros. Los tiempos de latencia se asignan a horas máximas específicas en las que el dispositivo debe poder salir de su estado de suspensión y escribir el estado totalmente funcional (D0).
PC_REBALANCE_TYPE La enumeración PC_REBALANCE_TYPE describe el tipo de compatibilidad para el reequilibrio.
PcStreamResourceType En este tema se describe la enumeración PcStreamResourceType y se describen sus miembros. La enumeración PcStreamResourceType se usa para definir el tipo de recursos utilizados para el streaming de audio específico.