Método IAdapterPnpManagement::P npStop (portcls.h)
O método PnpStop fornece uma notificação depois de interromper todas as operações do Ioctl e mover fluxos ativos de run|pause|adquirir estado para interromper o estado.
Sintaxe
void PnpStop();
Retornar valor
Nenhum
Comentários
O PnpStop é invocado por Portcls depois de interromper todas as operações do Ioctl e mover fluxos ativos da execução|pausa|adquirir estado para interromper o estado. Essa chamada não é feita ao manter o bloqueio global do dispositivo. Assim, o driver de miniporto tem a oportunidade de aguardar por suas operações assíncronas (itens de trabalho, dpc, threads assíncronos) e cancelar o registro de seus subdispositivos de áudio. Antes de retornar dessa chamada, o miniporto deve garantir que todos os recursos de hardware tenham sido liberados.
O miniporto não deve esperar que os objetos de miniporto/fluxo atuais sejam excluídos, pois não está claro quando os clientes de áudio existentes liberarão os identificadores atuais. O thread PnpStop não pode ser bloqueado para sempre sem travar o sistema, ou seja, esse é um thread PnP/Power.
IAdapterPnpManagement::P npstop é chamado após:
- Todos os subdispositivos de áudio de miniport foram notificados.
- Todos os fluxos pertencentes aos subdispositivos de áudio foram interrompidos.
- Todas as interfaces Pnp foram desativadas.
- Todas as E/S pendentes foram canceladas.
Para obter mais informações, consulte Implementar o reequilíbrio PnP para drivers de áudio PortCls.
Requisitos
Requisito | Valor |
---|---|
Cabeçalho | portcls.h |
IRQL | PASSIVE_LEVEL |