Partager via


OID_PM_REMOVE_PROTOCOL_OFFLOAD

En tant que requête définie, NDIS et les pilotes de protocole utilisent le OID_PM_REMOVE_PROTOCOL_OFFLOAD OID pour supprimer un déchargement de protocole de gestion de l’alimentation d’une carte réseau. Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers un identificateur de déchargement du protocole ULONG .

Notes

Les pilotes NDIS et de protocole utilisent le OID_PM_REMOVE_PROTOCOL_OFFLOAD OID pour supprimer un déchargement de protocole de la carte réseau sous-jacente.

Données. SET_INFORMATION. Le membre InformationBuffer de la structure NDIS_OID_REQUEST doit pointer vers une valeur ULONG pour un identificateur de déchargement de protocole précédemment ajouté. NDIS définit cet identificateur de déchargement de protocole dans le membre ProtocolOffloadId de la structure NDIS_PM_PROTOCOL_OFFLOAD lorsque NDIS a envoyé la demande OID OID_PM_ADD_PROTOCOL_OFFLOAD précédente à la carte réseau sous-jacente.

Remarques pour les enregistreurs de pilotes miniports

NDIS garantit que la taille de la mémoire tampon est au moins sizeof(ULONG) et contient un ID de déchargement de protocole valide. Par conséquent, la fonction MiniportOidRequest d’un pilote miniport doit retourner NDIS_STATUS_SUCCESS pour cette demande.

Note Si le pilote miniport est réinitialisé, sa fonction MiniportOidRequest doit retourner NDIS_STATUS_NOT_ACCEPTED.

Retourner les codes status

NDIS retourne l’un des codes status suivants pour cette demande :

NDIS_STATUS_SUCCESS
Le déchargement du protocole a été supprimé avec succès.

NDIS_STATUS_PENDING
La demande est en attente d’achèvement. NDIS transmet le code status final et les résultats au gestionnaire de saisie semi-automatique de la requête OID de l’appelant une fois la demande terminée.

NDIS_STATUS_INVALID_LENGTH
La mémoire tampon d’informations est trop petite. NDIS définit les DONNÉES. SET_INFORMATION. BytesNeeded member dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise, en octets.

NDIS_STATUS_FILE_NOT_FOUND
L’identificateur de déchargement du protocole dans la requête OID n’est pas valide.

Spécifications

Version

Pris en charge dans NDIS 6.20 et versions ultérieures. Obligatoire pour les pilotes miniport.

En-tête

Ntddndis.h (inclure Ndis.h)

Voir aussi

NDIS_OID_REQUEST

NDIS_PM_PROTOCOL_OFFLOAD

OID_PM_ADD_PROTOCOL_OFFLOAD