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

Consulte también

PCSTREAMRESOURCE_DESCRIPTOR

PcRemoveStreamResource