NdisRegisterProtocolDriver, fonction (ndis.h)

Un pilote de protocole appelle la fonction NdisRegisterProtocolDriver pour inscrire ses fonctions ProtocolXxx auprès de NDIS.

Syntaxe

NDIS_STATUS NdisRegisterProtocolDriver(
  [in, optional] NDIS_HANDLE                           ProtocolDriverContext,
  [in]           PNDIS_PROTOCOL_DRIVER_CHARACTERISTICS ProtocolCharacteristics,
  [out]          PNDIS_HANDLE                          NdisProtocolHandle
);

Paramètres

[in, optional] ProtocolDriverContext

Handle vers une zone de contexte allouée par le pilote où le pilote conserve les informations d’état et de configuration.

[in] ProtocolCharacteristics

Pointeur vers un NDIS_PROTOCOL_DRIVER_CHARACTERISTICS structure que le pilote de protocole a créée et initialisée avec ses points d’entrée de fonction ProtocolXxx .

[out] NdisProtocolHandle

Pointeur vers une variable de handle fournie par l’appelant. NDIS écrit un handle dans cette variable qui identifie de manière unique le pilote inscrit. Le pilote doit enregistrer ce handle pour l’utiliser dans les appels de fonction NdisXxx suivants.

Valeur retournée

NdisRegisterProtocolDriver retourne l’une des valeurs status suivantes :

Remarques

Un pilote de protocole appelle la fonction NdisRegisterProtocolDriver à partir de sa routine DriverEntry . Pour plus d’informations sur DriverEntry, consultez DriverEntry des pilotes de protocole NDIS.

Les pilotes qui appellent NdisRegisterProtocolDriver doivent être préparés pour un appel immédiat à l’une de leurs fonctions ProtocolXxx .

Chaque pilote de protocole exporte un ensemble de fonctions ProtocolXxx en configurant le NDIS_PROTOCOL_DRIVER_CHARACTERISTICS structure et appelez NdisRegisterProtocolDriver. NDIS copie cette structure dans le stockage interne de la bibliothèque NDIS.

Pour permettre aux pilotes de protocole d’inscrire des services facultatifs, NDIS appelle la fonction ProtocolSetOptions dans le contexte de NdisRegisterProtocolDriver.

Les pilotes de protocole appellent le Fonction NdisDeregisterProtocolDriver pour libérer les ressources précédemment allouées avec NdisRegisterProtocolDriver.

Configuration requise

Voir aussi

DriverEntry des pilotes de protocole NDIS

NdisDeregisterProtocolDriver

NdisSetOptionalHandlers