Share via

Función PcRemoveStreamResource (portcls.h)

  • Artículo

PcRemoveStreamResource quita un recurso de secuencia existente. Cualquier controlador puede llamar a PcRemoveStreamResource, incluidos los controladores de miniporte waveRT que no son de audio, que tiene interrupciones o subprocesos asociados a una secuencia de audio. También se puede llamar por controladores de miniporte waveRT de audio.

Sintaxis

PORTCLASSAPI NTSTATUS PcRemoveStreamResource(
  [in] PCSTREAMRESOURCE ResourceHandle
);

Parámetros

[in] ResourceHandle

PCSTREAMRESOURCE: identificador de recursos devuelto por PcAddStreamResource.
Para obtener más información, vea PcAddStreamResource y PCSTREAMRESOURCE_DESCRIPTOR.

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.

Los controladores de audio deben quitar un recurso registrado anteriormente. Los controladores pueden anular el registro de un recurso como resultado de las siguientes actividades del sistema:

  • Vuelva a equilibrar el dispositivo cuando cambien los recursos de E/S.
  • Transiciones de energía del dispositivo (D0<- ->Dx) cuando se destruyen o crean recursos. Por ejemplo, las interrupciones pueden desconectarse al ir a Dx y volver a conectarse con el cambio a D0.
  • Cuando se detiene el procesamiento, se quitan sorpresas, se quitan los eventos plug and play.
  • Cuando los puntos de conexión de audio asociados desaparezcan. Por ejemplo, si se crea un subproceso para controlar el flujo de datos de un punto de conexión y se quita el punto de conexión. En este caso, el controlador debe quitar el recurso de flujo de subprocesos.
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

PcAddStreamResource

PcStreamResourceType