Función PcAddStreamResource (portcls.h)
PcAddStreamResource agrega un recurso de secuencia. Se admiten dos tipos de recursos de secuencia: interrupciones y subprocesos propiedad del controlador. Cualquier controlador de miniport de WaveRT que no sea de audio que tenga interrupciones o subprocesos asociados a una secuencia de audio puede llamar a PcAddStreamResource. También se puede llamar por controladores de miniporte waveRT de audio.
Sintaxis
PORTCLASSAPI NTSTATUS PcAddStreamResource(
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in] PVOID ResourceSet,
[in] PPCSTREAMRESOURCE_DESCRIPTOR ResourceDescriptor,
[out] PCSTREAMRESOURCE *ResourceHandle
);
Parámetros
[in] PhysicalDeviceObject
PDEVICE_OBJECT: el PDO de la pila de dispositivos mediante este recurso.
[in] ResourceSet
PVOID: reservado para uso futuro, establecido en NULL. En este momento solo se admiten recursos con ámbito de dispositivo.
[in] ResourceDescriptor
PPCSTREAMRESOURCE_DESCRIPTOR: el recurso que se va a agregar. Para obtener más información, consulte PCSTREAMRESOURCE_DESCRIPTOR.
[out] ResourceHandle
PCSTREAMRESOURCE*: la ubicación que contendrá el identificador de recursos. Para obtener más información, vea PcRemoveStreamResource.
Valor devuelto
STATUS_SUCCESS: el controlador pudo registrar el recurso del PDO especificado.
STATUS_INVALID_PARAMETER: el controlador devuelve este error si encuentra algún otro parámetro no válido, aparte de los casos específicos de otras instancias de estado de error.
Se pueden devolver códigos de estado estándar adicionales.
Comentarios
Para ayudar a garantizar una operación sin problemas, los controladores de audio deben registrar sus recursos de streaming con portcls. Esto permite que el sistema operativo administre los recursos para evitar interferencias entre el streaming de audio y otros subsistemas.
Stream recursos son los recursos que usa el controlador de audio para procesar secuencias de audio o garantizar el flujo de datos de audio.
Todos los controladores de audio deben registrar sus recursos de secuencia con el controlador de clase de audio. El controlador registra los siguientes tipos de recursos: interrupciones, subprocesos propiedad del controlador y dependencias en los recursos de otra pila de audio (ejemplo: pilas de controladores de audio paralelos). Consulte la definición de PCSTREAMRESOURCE_DESCRIPTOR para obtener más información.
El controlador de audio debe asegurarse de que el recurso es válido al realizar esta llamada.
Los controladores de audio que solo se ejecutan en Windows 10 pueden usar PcAddStreamResource y PcRemoveStreamResource. En el caso de los controladores miniport de Audio waveRT que también deben ejecutarse en versiones anteriores de Windows, use AddStreamResource y RemoveStreamResource.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10 |
| Servidor mínimo compatible | Windows Server 2016 |
| Plataforma de destino | Windows |
| Encabezado | portcls.h |
| Library | Portcls.lib |
| Archivo DLL | N/D |
| IRQL | PASSIVE_LEVEL |