Demandes d’OID du pilote Miniport CoNDIS

NDIS appelle la fonction MiniportCoOidRequest d’un pilote miniport CoNDIS pour envoyer une requête OID pour interroger ou définir des informations dans le pilote. NDIS appelle MiniportCoOidRequest pour son propre compte ou pour le compte d’un pilote qui a appelé la fonction NdisCoOidRequest .

NDIS transmet à MiniportCoOidRequest un pointeur vers une structure de NDIS_OID_REQUEST qui contient les informations de requête. La structure de requête contient un identificateur OID_Xxx qui indique le type de requête et d’autres membres pour définir les données de requête.

Le membre Délai d’expiration spécifie un délai d’attente, en secondes, pour la demande. NDIS peut réinitialiser le pilote ou annuler la demande si le délai d’expiration expire avant que le pilote termine la demande.

Le membre RequestId spécifie un identificateur facultatif pour la demande. Les pilotes Miniport peuvent définir le membre RequestId d’une indication status sur la valeur que le pilote a obtenue du membre RequestId d’une requête OID associée. En règle générale, les pilotes miniport peuvent ignorer ce membre. Si un pilote doit définir ce membre, il doit utiliser l’une des valeurs requises, qui sont spécifiées dans la page de référence pour l’OID particulier. Pour plus d’informations sur les indications status, consultez Indications d’état du pilote Miniport CoNDIS.

Un pilote miniport peut effectuer une requête OID de manière synchrone en retournant une status de réussite ou d’échec. Le pilote peut effectuer une requête OID de manière asynchrone en retournant NDIS_STATUS_PENDING. Dans ce cas, le pilote doit appeler la fonction NdisMCoOidRequestComplete pour terminer l’opération.

Si la fonction MiniportCoOidRequest retourne NDIS_STATUS_PENDING, NDIS peut appeler MiniportCoOidRequest avec une autre demande pour l’adaptateur avant la fin de la demande en attente. Notez que cela est différent de l’interface NDIS sans connexion où toutes les requêtes OID sont sérialisées.

NDIS peut appeler la fonction MiniportCancelOidRequest d’un pilote miniport pour annuler une requête OID CoNDIS.