Compartilhar via

Função NdisIMNotifyPnPEvent (ndis.h)

  • Artigo

Nota NDIS 5. x foi preterido e substituído pelo NDIS 6. x. Para obter o novo desenvolvimento de driver NDIS, consulte Drivers de rede começando com o Windows Vista. Para obter informações sobre como portar o NDIS 5. x drivers para NDIS 6. x, consulte Portabilidade de drivers NDIS 5.x para NDIS 6.0.

NdisIMNotifyPnPEvent propaga a notificação de um evento Plug and Play ou power management para um driver sobreposto.

Sintaxe

NDIS_STATUS NdisIMNotifyPnPEvent(
  [in] NDIS_HANDLE    MiniportHandle,
  [in] PNET_PNP_EVENT NetPnPEvent
);

Parâmetros

[in] MiniportHandle

A entrada do identificador para MiniportInitialize. Esse identificador representa o driver de miniporto afetado pelo evento Plug and Play ou Power Management passado para a função ProtocolPnPEvent do chamador.

[in] NetPnPEvent

Ponteiro para uma estrutura de NET_PNP_EVENT, que descreve o evento Plug and Play ou o evento power management que está sendo indicado para o driver de protocolo.

Retornar valor

NdisIMNotifyPnPEvent pode retornar um dos seguintes:

Código de retorno Descrição
NDIS_STATUS_SUCCESS O driver sobressociante foi propagado com êxito Plug and Play evento foi bem-sucedido.
NDIS_STATUS_FAILURE O driver sobressociante falhou no evento de Plug and Play propagado.

O valor retornado é significativo somente quando o evento propagado é um NetEventQueryPower ou um NetEventQueryRemove. Para todos os outros eventos propagados, o valor retornado é sempre NDIS_STATUS_SUCCESS.

Comentários

Um driver intermediário do NDIS chama NdisIMNotifyPnPEvent no contexto da função ProtocolPnPEvent do driver para propagar a notificação de um evento de Plug and Play ou Power Management para o driver sobreposto.

Se o evento propagado for um NetEventQueryPower ou um NetEventQueryRemove, o driver intermediário deverá marcar o valor NDIS_STATUS retornado por NdisIMNotifyPnPEvent. Se o status retornado for NDIS_STATUS_SUCCESS, o driver intermediário deverá manipular o evento internamente como de costume e, em seguida, retornar NDIS_STATUS_SUCCESS de sua função ProtocolPnPEvent. Se o status retornado for NDIS_STATUS_FAILURE, o driver intermediário deverá retornar NDIS_STATUS_FAILURE de seu ProtocolPnPEvent sem processamento adicional.

Para todos os outros eventos propagados, NdisIMNotifyPnPEvent sempre retorna NDIS_STATUS_SUCCESS. A função ProtocolPnPEvent do driver intermediário nesses casos deve propagar a NDIS_STATUS retornada por NdisIMNotifyPnPEvent.

A forma como o driver intermediário processa um NetEventSetPower recebido por sua função ProtocolPnPEvent depende do estado de energia do dispositivo especificado. Se o estado de energia do dispositivo especificado for NdisDeviceStateD0, o driver intermediário deverá manipular o evento internamente como de costume e chamar NdisIMNotifyPnPnPEvent. Para qualquer outro estado de energia do dispositivo especificado, o driver intermediário deve primeiro chamar NdisIMNotifyPnPEvent e, em seguida, manipular o evento internamente como de costume.

Um driver intermediário deve chamar NdisIMNotifyPnPEvent para propagar um NetEventReconfigure ou NetEventBindList somente se NetEventReconfigure ou NetEventBindList for indicado em um Protocolo Não NULLBindingContext. Se um NetEventReconfigure ou NetEventBindList for indicado em um Protocolo NULLBindingContext, o driver intermediário não deverá chamar NdisIMNotifyPnPEvent para propagar o evento.

Se um driver intermediário manipular um NetEventReconfigure ou um NetEventBindList, ele deverá validar todos os dados associados ao evento. (Para obter mais informações sobre esses dados, consulte NET_PNP_EVENT para Drivers de Protocolo.)

O suporte do sistema para NdisIMNotifyPnPEvent está disponível no Windows XP e em versões posteriores.

  • Plataforma de destino: Universal
  • Versão: não há suporte para drivers NDIS 6.0 no Windows Vista. Em vez disso, use NdisMNetPnPEvent. Com suporte para drivers NDIS 5.1 no Windows Vista e windows XP.

Requisitos

Requisito Valor
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL PASSIVE_LEVEL

Confira também