OID_PM_WOL_PATTERN_LIST

En tant que requête, les pilotes surlysants peuvent utiliser l’OID OID_PM_WOL_PATTERN_LIST pour énumérer le réveil sur les modèles LAN définis sur une carte réseau sous-jacente. Après un retour réussi de la requête, l'InformationBuffer membre 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.

Remarques

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 mise en éveil sur les modèles LAN définis sur une carte réseau sous-jacente.

Pour chaque structure NDIS_PM_WOL_PATTERN de la liste, NDIS définit le membre NextWoLPatternOffset le décalage du début de la mémoire tampon d’informations OID (autrement dit, le début de la mémoire tampon que le InformationBuffer membre de la structure NDIS_OID_REQUEST pointe) au début de la structure de NDIS_PM_WOL_PATTERN suivante dans la liste. Le décalage dans la NextWoLPatternOffset membre 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.

S’il n’existe aucun modèle WOL défini sur la carte réseau, NDIS définit la DATA. QUERY_INFORMATION. Octets écrits membre de la structure NDIS_OID_REQUEST sur zéro et retourne NDIS_STATUS_SUCCESS pour la requête. Données dans le DATA. QUERY_INFORMATION. Le membre InformationBuffer n’est pas modifié par NDIS.

NDIS retourne l’un des codes d’état suivants pour la demande :

NDIS_STATUS_SUCCESS
La demande s’est terminée avec succès. Le InformationBuffer contient un pointeur vers une liste de modèles WOL, le cas échéant.

NDIS_STATUS_PENDING
La requête est en attente d’achèvement. Le code d’état final et les résultats sont transmis au gestionnaire d’achèvement de la demande OID de l’appelant.

NDIS_STATUS_BUFFER_TOO_SHORT
La mémoire tampon d’informations était trop courte. NDIS définit la DATA. QUERY_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille minimale de mémoire tampon requise.

NDIS_STATUS_FAILURE
La demande a échoué pour des raisons autres que les raisons précédentes.

Exigences

Version

Pris en charge dans NDIS 6.20 et versions ultérieures. Non demandé pour les pilotes miniport. (Voir la section Remarques.)

En-tête

Ntddndis.h (include Ndis.h)

Voir aussi

NDIS_OID_REQUEST

NDIS_PM_WOL_PATTERN

OID_PM_ADD_WOL_PATTERN

OID_PM_REMOVE_WOL_PATTERN

OID_PNP_WAKE_UP_PATTERN_LIST