OID_NDK_SET_STATE

En tant que requête définie, les pilotes NDIS et overlying utilisent l’OID OID_NDK_SET_STATE pour définir l’état de la fonctionnalité NDK de l’adaptateur miniport.

Les pilotes miniport NDIS 6.30 et ultérieurs qui fournissent des services NDK doivent prendre en charge cet OID. Sinon, cet OID est facultatif.

Remarques

NDIS émet cet OID avec le membre InformationBuffer de la structure NDIS_OID_REQUEST pointant vers un BOOLEAN et membre InformationBufferLeng th égal à sizeof(BOOLEAN).

• Si la valeur booléenne est TRUE et que la valeur de mot clé *NetworkDirect n’est pas nulle, la fonctionnalité NDK de l’adaptateur miniport doit être activée.

  Le pilote miniport peut lire la valeur de mot clé *NetworkDirect en procédant comme suit :

  1. Appelez NdisOpenConfigurationEx avec le handle NDIS que la fonction NdisMRegisterMiniportDriver retournée lorsque le pilote miniport a été initialisé. Pour plus d’informations sur l’appel NdisOpenConfigurationEx, consultez Lecture du Registre dans un pilote Miniport NDIS 6.0.

  2. Appelez NdisReadConfiguration, en passant :

     • « *NetworkDirect » pour le paramètre mot clé

     • NdisParameterInteger pour le paramètre ParameterType

• Si la valeur booléenne est FALSE, la fonctionnalité NDK de l’adaptateur miniport doit être désactivée.

Pour activer ou désactiver sa fonctionnalité NDK, la fonction de rappel MiniportOidRequest du pilote miniport doit suivre les étapes décrites dans Activation et désactivation de la fonctionnalité NDK.

Remarque Un pilote miniport compatible NDK ne doit jamais appeler NdisMNetPnPEvent à partir du contexte de sa fonction MiniportOidRequest, car cela peut entraîner un interblocage. Au lieu de cela, il doit appeler NdisMNetPnPEvent à partir d’un autre contexte ou mettre en file d’attente un élément de travail.

Une fonction miniport compatible avec NDK doit retourner STATUS_SUCCESS pour une requête OID OID_NDK_SET_STATE, sauf si une défaillance se produit. Le pilote ne doit pas retourner NDIS_STATUS_PENDING.

Exigences

Voir aussi

NDIS_OID_REQUEST

NdisMNetPnPEvent

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER