OID_PNP_ADD_WAKE_UP_PATTERN
L’OID OID_PNP_ADD_WAKE_UP_PATTERN 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, sont décrits 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é dans la mémoire hôte ou sur la carte réseau, en fonction des fonctionnalités de la carte réseau.
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient les éléments suivants :
Une 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 doivent être comparés aux octets correspondants dans le modèle. Le masque commence par le premier octet du paquet. Le masque suit immédiatement la structure NDIS_PM_PACKET_PATTERN dans InformationBuffer. Pour plus d’informations sur le fonctionnement de ce masque, consultez la spécification référence de la gestion de l’alimentation de la classe de périphériques réseau.
Modèle de mise en éveil, qui commence les octets PatternOffset à partir du début de InformationBuffer. Pour plus d’informations sur les modèles de mise en éveil, consultez la spécification référence de la gestion de l’alimentation de la classe de périphériques 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 demande au pilote miniport sous-jacent en appelant NdisRequest ou NdisCoRequest.
Spécifications
Version |
Pris en charge dans NDIS 6.0 et NDIS 6.1. Pour NDIS 6.20 et versions ultérieures, utilisez plutôt OID_PM_ADD_WOL_PATTERN . |
En-tête |
Ntddndis.h (inclure Ndis.h) |