OID_GEN_ISOLATION_PARAMETERS
Les pilotes NDIS et overlying émettent une demande d’identificateur d’objet (OID) de OID_GEN_ISOLATION_PARAMETERS pour obtenir les paramètres de configuration multilocataire (isolation) qui sont définis sur le port d’une carte réseau de machine virtuelle.
Bien que chaque domaine de routage soit configuré séparément sur le port, cet OID retourne des paramètres pour tous les domaines de routage dans une requête unique.
Un pilote qui se superpose doit émettre cet OID en deux étapes :
- Io interroge la taille de mémoire tampon requise, émet la requête OID avec le membre Size du membre Header de la structure NDIS_ISOLATION_PARAMETERS défini sur NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1. (Voir NDIS_STATUS_INVALID_LENGTH ci-dessous.)
- Émettez l’OID avec un objet InformationBuffer de la taille requise.
Si la requête OID est correctement effectuée, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une mémoire tampon. Cette mémoire tampon contient les données suivantes, dans l’ordre :
Structure NDIS_ISOLATION_PARAMETERS
Une ou plusieurs structures NDIS_ROUTING_DOMAIN_ENTRY , une pour chaque domaine de routage
Une ou plusieurs structures NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY , regroupées par domaine de routage
Dans chaque structure NDIS_ROUTING_DOMAIN_ENTRY , le membre FirstIsolationInfoEntryOffset contient le décalage entre le début de la mémoire tampon d’informations OID (c’est-à-dire le début de la mémoire tampon vers laquelle pointe le membre InformationBuffer de la structure NDIS_OID_REQUEST ) et le premier NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY pour ce domaine de routage. Le décalage dans le membre NextIsolationInfoEntryOffset de la dernière structure de la liste est égal à zéro.
Si aucun paramètre de configuration multilocataire n’est défini sur la carte réseau de machine virtuelle, le pilote miniport de la carte réseau définit les DONNÉES. QUERY_INFORMATION. OctetSSécrit de la structure NDIS_OID_REQUEST à zéro et retourne NDIS_STATUS_SUCCESS. Dans ce cas, les données dans les DONNÉES. QUERY_INFORMATION. Le membre InformationBuffer n’est pas modifié par le pilote miniport.
Notes
Codes d’état de retour
Le pilote miniport de carte réseau de machine virtuelle retourne l’un des codes status suivants pour cette demande OID :
| Code d’état | Description |
|---|---|
NDIS_STATUS_SUCCESS |
La demande OID s’est terminée avec succès. |
NDIS_STATUS_INVALID_LENGTH |
La longueur de la mémoire tampon d’informations est trop petite pour renvoyer les informations demandées. Le pilote miniport de carte réseau de machine virtuelle définit les DONNÉES. METHOD_INFORMATION. BytesNeeded member dans la structure NDIS_OID_REQUEST à la taille minimale de mémoire tampon, en octets, qui est requise. |
NDIS_STATUS_FAILURE |
La demande a échoué pour d’autres raisons. |
Spécifications
Version |
Pris en charge dans NDIS 6.40 et versions ultérieures. |
En-tête |
Ntddndis.h (inclure Ndis.h) |