OID_NDK_SET_STATE
En tant que demande de jeu, NDIS et les pilotes sur-menting utilisent l’OID_NDK_SET_STATE OID pour définir l’état de la fonctionnalité NDK de l’adaptateur miniport.
Les pilotes miniportS NDIS 6.30 et versions ultérieures qui fournissent des services NDK doivent prendre en charge cet OID. Sinon, cet OID est facultatif.
Notes
NDIS émet cet OID avec le membre InformationBuffer de la structure NDIS_OID_REQUEST pointant vers un membre BOOLEAN et InformationBufferLength égal à sizeof(BOOLEAN).
Si la valeur BOOLEAN est TRUE et que la valeur *NetworkDirect mot clé est différente de zéro, la fonctionnalité NDK de l’adaptateur miniport doit être activée.
Le pilote miniport peut lire la valeur *NetworkDirect mot clé en procédant comme suit :
Appelez NdisOpenConfigurationEx avec le handle NDIS que la fonction NdisMRegisterMiniportDriver a retourné lors de l’initialisation du pilote miniport. Pour plus d’informations sur l’appel de NdisOpenConfigurationEx, consultez Lecture du Registre dans un pilote miniport NDIS 6.0.
Appelez NdisReadConfiguration, en passant :
« *NetworkDirect » pour le paramètre Keyword
NdisParameterInteger pour le paramètre ParameterType
Si la valeur BOOLEAN 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 des fonctionnalités NDK.
Note Un pilote miniport compatible NDK ne doit jamais appeler NdisMNetPnPEvent à partir du contexte de sa fonction MiniportOidRequest , car cela peut provoquer un blocage. Au lieu de cela, il doit appeler NdisMNetPnPEvent à partir d’un autre contexte ou mettre en file d’attente un élément de travail.
La fonction MiniportOidRequest d’un pilote miniport compatible 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.
Configuration requise
Client minimal pris en charge |
Aucun pris en charge |
Serveur minimal pris en charge |
Windows Server 2012 |
Version |
Pris en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (inclure Ndis.h) |