Método IPortClsStreamResourceManager::RemoveStreamResource (portcls.h)

  • Artículo

RemoveStreamResource quita un recurso de flujo existente. El método RemoveStreamResource solo puede ser utilizado por los controladores de miniport de waveRT de audio.

Sintaxis

NTSTATUS RemoveStreamResource(
  PCSTREAMRESOURCE ResourceHandle
);

Parámetros

ResourceHandle

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

Valor devuelto

Este método devuelve NTSTATUS que contiene:

  • 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 la operación sin problemas, los controladores de audio deben registrar sus recursos de streaming con portcls. Esto permite que el sistema operativo administre 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 previamente. 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 secuencia de subprocesos.

El controlador de audio debe asegurarse de que el recurso es válido al realizar esta llamada.

Requisitos

Requisito Valor
Header portcls.h
IRQL PASSIVE_LEVEL

Consulte también

IPortClsStreamResourceManager