Compartilhar via


OID_PM_REMOVE_PROTOCOL_OFFLOAD

Como uma solicitação definida, o NDIS e os drivers de protocolo usam o OID OID_PM_REMOVE_PROTOCOL_OFFLOAD para remover um descarregamento de protocolo de gerenciamento de energia de um adaptador de rede. O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para um identificador de descarregamento de protocolo ULONG.

Observações

Os drivers de protocolo e NDIS usam o OID OID_PM_REMOVE_PROTOCOL_OFFLOAD para remover um descarregamento de protocolo do adaptador de rede subjacente.

O DATA. SET_INFORMATION. O informationBuffer membro da estrutura de NDIS_OID_REQUEST deve apontar para um valor ULONG para um identificador de descarregamento de protocolo adicionado anteriormente. O NDIS define esse identificador de descarregamento de protocolo no protocolOffloadId membro da estrutura NDIS_PM_PROTOCOL_OFFLOAD quando o NDIS enviou a solicitação OID OID_PM_ADD_PROTOCOL_OFFLOAD anterior ao adaptador de rede subjacente.

Comentários para gravadores de driver de miniporto

O NDIS garante que o tamanho do buffer seja pelo menos tamanho de(ULONG) e contenha uma ID de descarregamento de protocolo válida. Portanto, a funçãoMiniportOidRequest dedo driver de miniport deve retornar NDIS_STATUS_SUCCESS para essa solicitação.

Observação Se o driver de miniporto estiver sendo redefinido, sua funçãoMiniportOidRequestdeverá retornar NDIS_STATUS_NOT_ACCEPTED.

Retornar códigos de status

O NDIS retorna um dos seguintes códigos de status para esta solicitação:

NDIS_STATUS_SUCCESS
O descarregamento de protocolo foi removido com êxito.

NDIS_STATUS_PENDING
A solicitação está pendente de conclusão. O NDIS passará o código de status final e os resultados para o manipulador de conclusão da solicitação OID do chamador após a conclusão da solicitação.

NDIS_STATUS_INVALID_LENGTH
O buffer de informações é muito pequeno. O NDIS define os dados de . SET_INFORMATION. BytesNeededed membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário, em bytes.

NDIS_STATUS_FILE_NOT_FOUND
O identificador de descarregamento de protocolo na solicitação OID não é válido.

Requisitos

Versão

Com suporte no NDIS 6.20 e posterior. Obrigatório para drivers de miniporto.

Cabeçalho

Ntddndis.h (inclua Ndis.h)

Consulte também

NDIS_OID_REQUEST

NDIS_PM_PROTOCOL_OFFLOAD

OID_PM_ADD_PROTOCOL_OFFLOAD