Compartilhar via

Função PcRemoveStreamResource (portcls.h)

  • Artigo

PcRemoveStreamResource remove um recurso de fluxo existente. PcRemoveStreamResource pode ser chamado por qualquer driver, incluindo drivers de miniporto WaveRT que não sejam de áudio, que tem interrupções/threads associados a um fluxo de áudio. Ele também pode ser chamado por drivers de miniporta WaveRT de áudio.

Sintaxe

PORTCLASSAPI NTSTATUS PcRemoveStreamResource(
  [in] PCSTREAMRESOURCE ResourceHandle
);

Parâmetros

[in] ResourceHandle

PCSTREAMRESOURCE – identificador de recurso retornado por PcAddStreamResource.
Para obter mais informações, consulte PcAddStreamResource e PCSTREAMRESOURCE_DESCRIPTOR.

Retornar valor

STATUS_SUCCESS – o driver conseguiu registrar o recurso do PDO especificado.

STATUS_INVALID_PARAMETER – o driver retornará esse erro se encontrar qualquer outro parâmetro inválido, além dos casos específicos para outras instâncias de status de erro.

Códigos de status padrão adicionais podem ser retornados.

Comentários

Para ajudar a garantir a operação sem falhas, os drivers de áudio devem registrar seus recursos de streaming com portcls. Isso permite que o sistema operacional gerencie recursos para evitar interferências entre streaming de áudio e outros subsistemas.

Stream recursos são todos os recursos usados pelo driver de áudio para processar fluxos de áudio ou garantir o fluxo de dados de áudio.

Os drivers de áudio devem remover um recurso registrado anteriormente. Os drivers podem cancelar o registro de um recurso como resultado das seguintes atividades do sistema:

  • Balanceamento de dispositivo quando os recursos de E/S são alterados.
  • Transições de energia do dispositivo (D0<- ->Dx) quando os recursos são destruídos ou criados. Por exemplo, as interrupções podem ser desconectadas ao entrar em Dx e reconectadas com a mudança de volta para D0.
  • Ao processar parar, remova surpresa, remova eventos de plug and play.
  • Quando os pontos de extremidade de áudio associados desaparecem. Por exemplo, se um thread for criado para manipular o fluxo de dados de um ponto de extremidade e o ponto de extremidade for removido. Nesse caso, o driver deve remover o recurso de fluxo de thread.
O driver de áudio deve verificar se o recurso é válido ao fazer essa chamada.

Drivers de áudio executados apenas em Windows 10 podem usar PcAddStreamResource e PcRemoveStreamResource. Para drivers de miniporto waveRT de áudio que também precisam ser executados em versões anteriores do Windows, use AddStreamResource e RemoveStreamResource.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Windows
Cabeçalho portcls.h
Biblioteca Portcls.lib
DLL NA
IRQL PASSIVE_LEVEL

Confira também

PCSTREAMRESOURCE_DESCRIPTOR

PcAddStreamResource

PcStreamResourceType