OID_PM_WOL_PATTERN_LIST
En tant que requête, les pilotes sur-ment peuvent utiliser l’OID OID_PM_WOL_PATTERN_LIST pour énumérer les modèles de wake on LAN définis sur une carte réseau sous-jacente. Après un retour réussi de la requête, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une liste de structures NDIS_PM_WOL_PATTERN qui décrivent les modèles WOL actuellement ajoutés.
Notes
NDIS gère la requête pour les pilotes miniport. Les pilotes NDIS peuvent utiliser l’OID OID_PM_WOL_PATTERN_LIST pour obtenir la liste des modèles de wake on LAN définis sur une carte réseau sous-jacente.
Pour chaque structure NDIS_PM_WOL_PATTERN dans la liste, NDIS définit le membre NextWoLPatternOffset sur le décalage entre le début de la mémoire tampon d’informations OID (autrement dit, le début de la mémoire tampon vers laquelle pointe le membre InformationBuffer de la structure NDIS_OID_REQUEST ) au début de la structure NDIS_PM_WOL_PATTERN suivante dans la liste. Le décalage dans le membre NextWoLPatternOffset de la dernière structure de la liste est égal à zéro.
Pour les décalages dans une structure NDIS_PM_WOL_PATTERN autre que NextWoLPatternOffset (par exemple, NameBufferOffset), NDIS fournit des décalages relatifs au début de chaque structure NDIS_PM_WOL_PATTERN .
Si aucun modèle WOL n’est défini sur la carte réseau, NDIS définit les DONNÉES. QUERY_INFORMATION. BytesRite membre de la structure NDIS_OID_REQUEST à zéro et retourne NDIS_STATUS_SUCCESS pour la requête. Données dans data . QUERY_INFORMATION. Le membre InformationBuffer n’est pas modifié par NDIS.
NDIS retourne l’un des codes status suivants pour la requête :
NDIS_STATUS_SUCCESS
La demande s’est terminée avec succès. InformationBuffer contient un pointeur vers une liste de modèles WOL, le cas échéant.
NDIS_STATUS_PENDING
La demande est en attente d’achèvement. Le code et les résultats status finaux sont passés au gestionnaire d’achèvement des requêtes OID de l’appelant.
NDIS_STATUS_BUFFER_TOO_SHORT
La mémoire tampon d’informations était trop courte. NDIS définit les DONNÉES. QUERY_INFORMATION. Le membre BytesNeeded dans le NDIS_OID_REQUEST structure à la taille de mémoire tampon minimale requise.
NDIS_STATUS_FAILURE
La demande a échoué pour d’autres raisons que les raisons précédentes.
Spécifications
Version |
Pris en charge dans NDIS 6.20 et versions ultérieures. Non demandé pour les pilotes de miniport. (Voir la section Notes.) |
En-tête |
Ntddndis.h (inclure Ndis.h) |