Partager via


OID_PNP_ADD_WAKE_UP_PATTERN

Le OID_PNP_ADD_WAKE_UP_PATTERN OID est envoyé par un pilote de protocole à un pilote miniport pour spécifier un modèle de mise en éveil. Le modèle de mise en éveil, ainsi que son masque, est décrit par une structure NDIS_PM_PACKET_PATTERN.

Un protocole qui permet une mise en éveil de correspondance de modèle pour un pilote miniport (voir OID_PNP_ENABLE_WAKE_UP) utilise OID_PNP_ADD_WAKE_UP_PATTERN pour spécifier un modèle de mise en éveil. Le modèle de mise en éveil peut être stocké en mémoire hôte ou sur la carte réseau, en fonction des fonctionnalités de la carte réseau.

Le InformationBuffer membre de la structure NDIS_OID_REQUEST contient les éléments suivants :

  • Structure NDIS_PM_PACKET_PATTERN qui fournit des informations sur le modèle et son masque.

  • Masque qui indique quels octets d’un paquet entrant doit être comparé aux octets correspondants dans le modèle. Le masque commence par le premier octet du paquet. Le masque suit immédiatement la structure de NDIS_PM_PACKET_PATTERN dans le InformationBuffer. Pour plus d’informations sur le fonctionnement de ce masque, consultez la spécification de référence de gestion de l’alimentation de la classe de périphérique réseau.

  • Modèle de mise en éveil, qui commence PatternOffset octets à partir du début du InformationBuffer. Pour plus d’informations sur les modèles de mise en éveil, consultez la spécification de référence de gestion de l’alimentation de la classe d’appareil réseau .

Le nombre de modèles de mise en éveil que le pilote miniport peut accepter à partir d’un protocole peut dépendre de la disponibilité des ressources, telles que la mémoire hôte allouée par le pilote miniport pour ces modèles ou le stockage disponible dans la carte réseau. Si un pilote miniport ne peut pas ajouter un modèle de mise en éveil en raison de ressources insuffisantes, le pilote miniport retourne NDIS_STATUS_RESOURCES en réponse à OID_PNP_ADD_WAKE_UP_PATTERN.

Si un pilote de protocole tente d’ajouter un modèle en double, le pilote miniport doit retourner NDIS_STATUS_INVALID_DATA en réponse à OID_PNP_ADD_WAKE_UP_PATTERN.

Un pilote intermédiaire dans lequel le bord supérieur reçoit cette requête OID doit toujours propager la requête au pilote miniport sous-jacent en appelant NdisRequest ou NdisCoRequest.

Exigences

Version

Pris en charge dans NDIS 6.0 et NDIS 6.1. Pour NDIS 6.20 et versions ultérieures, utilisez OID_PM_ADD_WOL_PATTERN à la place.

En-tête

Ntddndis.h (include Ndis.h)

Voir aussi

NDIS_PM_PACKET_PATTERN

OID_PM_ADD_WOL_PATTERN