MINIPORT_CO_OID_REQUEST fonction de rappel (ndis.h)

2025-02-07

La fonction MiniportCoOidRequest gère une requête OID pour interroger ou définir des informations dans le pilote miniport CoNDIS.

Remarque Vous devez déclarer la fonction à l’aide du type MINIPORT_CO_OID_REQUEST. Pour plus d’informations, consultez la section Exemples suivants.

Syntaxe

MINIPORT_CO_OID_REQUEST MiniportCoOidRequest;

NDIS_STATUS MiniportCoOidRequest(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] NDIS_HANDLE MiniportVcContext,
       PNDIS_OID_REQUEST NdisRequest
)
{...}

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] MiniportVcContext

Handle vers une zone de contexte allouée par le pilote miniport dans laquelle le pilote miniport conserve son état de connexion par connexion virtuelle (VC). Le pilote miniport a fourni cette poignée à NDIS à partir de sa fonction MiniportCoCreateVc. Si la requête n’est pas spécifique à VC, ce paramètre est NULL.

NdisRequest

Pointeur vers une structure NDIS_OID_REQUEST qui contient à la fois la mémoire tampon et le paquet de requête du pilote miniport à gérer. Selon la requête, le pilote retourne les informations demandées dans la structure vers laquelle pointe ce paramètre.

Valeur de retour

MiniportCoOidRequest pouvez retourner l’une des valeurs d’état suivantes :

Retourner le code	Description
NDIS_STATUS_SUCCESS	Le pilote miniport a défini ou obtenu les données demandées.
NDIS_STATUS_PENDING	Le pilote miniport termine la requête de manière asynchrone. Une fois que le pilote miniport a terminé tout le traitement, il doit appeler le fonction NdisMCoOidRequestComplete pour informer NDIS que la requête est terminée.
NDIS_STATUS_INVALID_OID	La demande indiquant que le paramètre OidRequest spécifié n’était pas valide ou non reconnu.
NDIS_STATUS_NOT_SUPPORTED	La requête indiquant que le paramètre OidRequest spécifié a été reconnu, mais pas pris en charge par le pilote miniport.
NDIS_STATUS_BUFFER_TOO_SHORT	La mémoire tampon fournie par le paramètre OidRequest fourni était trop petite pour contenir les données demandées.
NDIS_STATUS_INVALID_LENGTH	La valeur spécifiée dans le membre InformationBufferLength de la structure NDIS_OID_REQUEST à OidRequest est incorrecte pour le code OID_ XXX spécifié.
NDIS_STATUS_INVALID_DATA	Un ou plusieurs des paramètres spécifiés pour la requête à OidRequest iwas non valide.
NDIS_STATUS_NOT_ACCEPTED	Une fois que NDIS appelle le MiniportDevicePnPEventNotify fonction pour indiquer une suppression surprise, NDIS appelle la fonction MiniportHaltEx du pilote. Si le pilote reçoit des demandes OID avant les appels NDIS MiniportHaltEx, il doit immédiatement effectuer ces demandes avec une valeur d’état de NDIS_STATUS_NOT_ACCEPTED.
NDIS_STATUS_REQUEST_ABORTED	Le pilote miniport a arrêté le traitement de la requête. Par exemple, NDIS a appelé le MiniportResetEx ou Fonction MiniportCancelOidRequest.

Remarques

NDIS appelle la fonction MiniportCoOidRequest pour gérer une requête OID pour interroger ou définir des informations dans un pilote miniport CoNDIS.

Pour inscrire miniportCoOidRequest, les pilotes miniport appellent la fonction NdisSetOptionalHandlers à partir de la fonction MiniportSetOptions. Dans MiniportSetOptions, le pilote miniport initialise une NDIS_MINIPORT_CO_CHARACTERISTICS structure et la transmet au paramètre OptionalHandlers de NdisSetOptionalHandlers.

NDIS appelle la fonction MiniportCoOidRequest en son propre nom ou au nom d’un pilote de protocole lié qui a appelé la fonction NdisCoOidRequest. Les pilotes miniport doivent examiner la demande fournie à OidRequest et effectuer l’action demandée. Pour plus d’informations sur les OID que les pilotes miniports gèrent, consultez NDIS OIDs.

Notez que NDIS ne valide pas le contenu spécifique à l’OID à OidRequest . Par conséquent, le pilote lui-même doit valider ce contenu. Si le pilote détermine que la valeur à définir est hors limites, elle doit échouer à la demande et retourner NDIS_STATUS_INVALID_DATA.

Si MiniportCoOidRequest retourne NDIS_STATUS_PENDING, NDIS peut appeler MiniportCoOidRequest avec une autre requête, pour l’adaptateur miniport spécifié à MiniportAdapterContext, avant la fin de la demande en attente. NDIS ne sérialise pas les requêtes OID orientées connexion.

exemples de

Pour définir une fonction MiniportCoOidRequest, vous devez d’abord fournir une déclaration de fonction qui identifie le type de fonction que vous définissez. Windows fournit un ensemble de types de fonctions pour les pilotes. La déclaration d’une fonction à l’aide des types de fonctions permet d'Analyse du code pour les pilotes, de vérificateur de pilotes statiques (SDV) et d’autres outils de vérification recherchent des erreurs, et il est nécessaire d’écrire des pilotes pour le système d’exploitation Windows.

Par exemple, pour définir une fonction MiniportCoOidRequest nommée « MyCoOidRequest », utilisez le type MINIPORT_CO_OID_REQUEST comme indiqué dans cet exemple de code :

MINIPORT_CO_OID_REQUEST MyCoOidRequest;

Ensuite, implémentez votre fonction comme suit :

_Use_decl_annotations_
NDIS_STATUS
 MyCoOidRequest(
    NDIS_HANDLE  MiniportAdapterContext,
    NDIS_HANDLE  MiniportVcContext,
    PNDIS_OID_REQUEST  OidRequest
    )
  {...}

Le type de fonction MINIPORT_CO_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_CO_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

Exigence	Valeur
client minimum pris en charge	Prise en charge dans NDIS 6.0 et versions ultérieures.
plateforme cible	Windows
d’en-tête	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL