MINIPORT_CANCEL_DIRECT_OID_REQUEST fonction de rappel (ndis.h)

NDIS appelle la fonction MiniportCancelDirectOidRequest d’un pilote miniport pour annuler une requête OID directe.

Syntaxe

MINIPORT_CANCEL_DIRECT_OID_REQUEST MiniportCancelDirectOidRequest;

VOID MiniportCancelDirectOidRequest(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PVOID RequestId
)
{...}

Paramètres

[in] MiniportAdapterContext

Handle vers une zone de contexte allouée par le pilote miniport dans sa fonction MiniportInitializeEx. Le pilote miniport utilise cette zone de contexte pour conserver les informations d’état d’un adaptateur miniport.

[in] RequestId

Identificateur d’annulation de la demande. Cet identificateur spécifie les requêtes OID directes qui correspondent à cette valeur dans le RequestId membre de la structure NDIS_OID_REQUEST.

Valeur de retour

Aucun

Remarques

MiniportCancelDirectOidRequest est une fonction facultative. Un pilote miniport inscrit cette fonction s’il gère les requêtes OID directes. Un pilote spécifie le point d’entrée MiniportCancelDirectOidRequest lorsqu’il appelle le fonction NdisMRegisterMiniportDriver. Un pilote miniport qui inscrit le Fonction MiniportDirectOidRequest doit également inscrire MiniportCancelDirectOidRequest.

Lorsque NDIS appelle MiniportCancelDirectOidRequest, le pilote miniport doit tenter d’appeler fonction NdisMDirectOidRequestComplete dès que possible.

NDIS appelle MiniportCancelDirectOidRequest lorsque l’initiateur de la requête annule la requête. Pour les requêtes OID directes, NDIS n’appelle pas MiniportCancelDirectOidRequest si le délai d’expiration expire. (Le délai d’attente est spécifié au Membre de chaque structure NDIS_OID_REQUEST.)

Si le traitement des demandes n’est toujours pas terminé dans un pilote miniport, le pilote appelle la fonction NdisMDirectOidRequestComplete avec l’état défini sur NDIS_STATUS_REQUEST_ABORTED.

Si le traitement de la demande n’est toujours pas terminé dans un pilote intermédiaire et que la demande a été propagée à un pilote sous-jacent, le pilote intermédiaire appelle le NdisCancelDirectOidRequest fonction avec le paramètre OidRequest défini sur la valeur qu’il a envoyée au pilote sous-jacent.

NDIS appelle MiniportCancelDirectOidRequest au <IRQL = DISPATCH_LEVEL.

exemples de

Par exemple, pour définir une fonction MiniportCancelDirectOidRequest nommée « MyCancelDirectOidRequest », utilisez le type MINIPORT_CANCEL_DIRECT_OID_REQUEST comme indiqué dans cet exemple de code :

MINIPORT_CANCEL_DIRECT_OID_REQUEST MyCancelDirectOidRequest;

Ensuite, implémentez votre fonction comme suit :

_Use_decl_annotations_
VOID
 MyCancelDirectOidRequest(
    NDIS_HANDLE  MiniportAdapterContext,
    PVOID  RequestId
    )
  {...}

Le type de fonction MINIPORT_CANCEL_DIRECT_OID_REQUEST est défini dans le fichier d’en-tête Ndis.h. Pour identifier plus précisément les erreurs lorsque vous exécutez les outils d’analyse du code, veillez à ajouter l’annotation Use_decl_annotations à votre définition de fonction. L’annotation Use_decl_annotations garantit que les annotations appliquées au type de fonction MINIPORT_CANCEL_DIRECT_OID_REQUEST dans le fichier d’en-tête sont utilisées. Pour plus d’informations sur la configuration requise pour les déclarations de fonction, consultez Déclaration de fonctions à l’aide de types de rôles de fonction pour les pilotes NDIS.

Pour plus d’informations sur Use_decl_annotations, consultez annoter le comportement de la fonction.

Exigences

Voir aussi

miniportDirectOidRequest

MiniportInitializeEx

NDIS_OID_REQUEST

NdisCancelDirectOidRequest

NdisMRegisterMiniportDriver