Adicionando e excluindo descarregamentos de protocolo de baixa potência

Para adicionar um descarregamento de protocolo de baixa potência, os drivers de protocolo NDIS emitem uma solicitação de definição de OID OID_PM_ADD_PROTOCOL_OFFLOAD. O InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_PM_PROTOCOL_OFFLOAD.

Observação Se um pacote de entrada corresponder a um protocolo descarregado e a um padrão (por exemplo, devido a um erro de configuração), o adaptador de rede deverá responder ao pacote e acordar o computador.

A estrutura NDIS_PM_PROTOCOL_OFFLOAD inclui as seguintes informações:

O NDIS atribui um identificador exclusivo para um adaptador de rede a cada protocolo descarregado. O identificador de descarregamento de protocolo é um valor exclusivo para cada um dos protocolos que são descarregados em um adaptador de rede. No entanto, o identificador de descarregamento de protocolo não é único a nível global em todos os adaptadores de rede. O NDIS passa esse identificador para o driver de miniporta subjacente quando o NDIS envia a solicitação OID OID_PM_ADD_PROTOCOL_OFFLOAD para o driver de miniporta. Se o descarregamento do protocolo for bem-sucedido, o NDIS retornará o identificador para o driver subjacente que descarrega o protocolo. O driver superior usa o identificador para remover um protocolo que foi descarregado anteriormente. O identificador de descarga de protocolo também é usado em indicações de estado para os controladores da camada superior quando um protocolo descarregado é removido de um adaptador de rede.

Os drivers de protocolo devem remover todos os protocolos descarregados de um adaptador de rede antes de fechar a ligação a esse adaptador de rede. Para remover um descarregamento de protocolo de baixa potência, um driver de protocolo envia uma solicitação de definição de OID de OID_PM_REMOVE_PROTOCOL_OFFLOAD. O InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para um identificador de descarregamento de um protocolo.

O NDIS permite que vários drivers de protocolo NDIS adicionem descargas de protocolo ao mesmo adaptador de rede. Para garantir que o conjunto correto de protocolos tenha sido descarregado para um adaptador de rede quando o número de protocolos descarregados solicitados for maior do que o que um adaptador de rede pode suportar, os drivers de protocolo atribuem uma prioridade a cada protocolo descarregado. Quando o NDIS não pode descarregar um novo protocolo de alta prioridade porque o adaptador de rede está sem recursos, o NDIS exclui um dos protocolos descarregados de prioridade mais baixa (se houver) e tenta descarregar o protocolo de alta prioridade novamente.

Observação um driver de miniporta deve falhar numa solicitação de adição de descarregamento de protocolo de baixa potência e retornar o código de status STATUS_NDIS_PM_PROTOCOL_OFFLOAD_LIST_FULL para permitir que o NDIS re-prioritize os descarregamentos de protocolo.

Se, como resultado do descarregamento de um protocolo de alta prioridade, um dos protocolos descarregados de prioridade mais baixa for excluído, o NDIS enviará uma indicação de status NDIS_STATUS_PM_OFFLOAD_REJECTED para notificar o driver sobrejacente que definiu o descarregamento do protocolo excluído. O StatusBuffer membro da estrutura NDIS_STATUS_INDICATION contém um identificador de descarregamento de protocolo do protocolo cuja descarga foi rejeitada. O NDIS forneceu o identificador de descarregamento de protocolo no membro ProtocolOffloadId da estrutura NDIS_PM_PROTOCOL_OFFLOAD.