Función PcRemoveStreamResource (portcls.h)
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 mediante controladores de miniport de audio WaveRT.
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.
Observaciones
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 recursos para evitar la interferencia entre el streaming de audio y otros subsistemas.
Los recursos de flujo son los recursos utilizados por 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 la migración 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 desaparecen. 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.
Los controladores de audio que solo se ejecutan en Windows 10 pueden usar PcAddStreamResource y PcRemoveStreamResource. Para los controladores de miniport de Audio waveRT que también deben ejecutarse en versiones anteriores de Windows, use AddStreamResource y RemoveStreamResource.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10 |
| servidor mínimo admitido | Windows Server 2016 |
| de la plataforma de destino de | Windows |
| encabezado de | portcls.h |
| biblioteca de | Portcls.lib |
| DLL de | NA |
| irQL | PASSIVE_LEVEL |