Método IPortClsStreamResourceManager::RemoveStreamResource (portcls.h)
RemoveStreamResource remove um recurso de fluxo existente. O método RemoveStreamResource só pode ser usado por drivers de miniporto waveRT de áudio.
Sintaxe
NTSTATUS RemoveStreamResource(
PCSTREAMRESOURCE ResourceHandle
);
Parâmetros
ResourceHandle
PCSTREAMRESOURCE – Identificador de recurso retornado por PcAddStreamResource. Para obter mais informações, consulte PcAddStreamResource.
Valor de retorno
Esse método retorna NTSTATUS que contém:
- STATUS_SUCCESS – O driver conseguiu registrar o recurso do PDO especificado.
- STATUS_INVALID_PARAMETER – O driver retornará esse erro se achar 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.
Observações
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. Os recursos de fluxo 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:
- O dispositivo será balanceado novamente quando os recursos de E/S forem 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 parar o processamento, remova-o de 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.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | portcls.h |
| IRQL | PASSIVE_LEVEL |