Partilhar via


OID_PM_REMOVE_PROTOCOL_OFFLOAD

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

Comentários

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

O DADOS. SET_INFORMATION. InformationBuffer membro da estrutura NDIS_OID_REQUEST deve apontar para um valor de 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 de OID_PM_ADD_PROTOCOL_OFFLOAD anterior para o adaptador de rede subjacente.

Comentários para escritores de drivers de miniporta

O NDIS garante que o tamanho do buffer seja pelo menos tamanho de(ULONG) e contenha um ID de descarregamento de protocolo válido. Portanto, a função deMiniportOidRequest de um driver de miniportadeve retornar NDIS_STATUS_SUCCESS para essa solicitação.

Observação Se o driver de miniporta estiver redefinindo, sua função MiniportOidRequest deverá retornar NDIS_STATUS_NOT_ACCEPTED.

Códigos de status de retorno

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

NDIS_STATUS_SUCCESS
O descarregamento do protocolo foi removido com êxito.

NDIS_STATUS_PENDING
O pedido está pendente de conclusão. O NDIS passará o código de status final e os resultados para o manipulador de conclusão de 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. SET_INFORMATION. BytesNeeded membro na estrutura de NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário, em bytes.

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

Requerimentos

Versão

Suportado no NDIS 6.20 e posterior. Obrigatório para condutores de miniportos.

Cabeçalho

Ntddndis.h (inclui Ndis.h)

Ver também

NDIS_OID_REQUEST

NDIS_PM_PROTOCOL_OFFLOAD

OID_PM_ADD_PROTOCOL_OFFLOAD