OID_PM_REMOVE_PROTOCOL_OFFLOAD

Artigo
06/14/2023

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 .

Comentários

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.

Os DADOS. SET_INFORMATION. O membro InformationBuffer da estrutura 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 membro ProtocolOffloadId da estrutura NDIS_PM_PROTOCOL_OFFLOAD quando o NDIS enviou a solicitação OID anterior OID_PM_ADD_PROTOCOL_OFFLOAD para o adaptador de rede subjacente.

Comentários para gravadores de driver de miniport

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

Nota Se o driver de miniporto estiver sendo redefinido, sua função MiniportOidRequest deverá 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 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. SET_INFORMATION. Membro BytesNeeded 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.