Partager via

Inscription et annulation d’un gestionnaire de région d’opération

  • Article

Un pilote de fonction de périphérique ACPI inscrit un gestionnaire de région d’opération en appelant RegisterOpRegionHandler et en fournissant les informations suivantes :

  • Objet d’appareil physique (PDO) représentant l’appareil ACPI qui définit la région d’opération.

  • Type d’accès, qui peut être cru ou cuit.

    Pour plus d’informations, consultez Accès à une région d’opération.

  • Type d’espace de région.

    Le fournisseur doit spécifier une valeur définie par le fournisseur de 0x80 à 0xFF. (Les valeurs inférieures à 0x80 sont définies par la spécification ACPI et sont réservées à un usage interne.)

  • Pointeur vers le gestionnaire de région d’opération du pilote.

    Le pilote ACPI accède à une région d’opération en appelant le gestionnaire de région d’opération du pilote.

  • Pointeur vers le contexte de la région d’opération.

    Le contexte de la région d’opération est spécifique au périphérique et est utilisé uniquement par le pilote de fonction. Lorsque le pilote ACPI appelle le gestionnaire de région d’opération, il transmet le contexte de la région d’opération au gestionnaire. En règle générale, il s’agit de l’extension d’appareil de l’objet d’appareil fonctionnel (FDO).

RegisterOpRegionHandler retourne un objet de région d’opération que le pilote de fonction utilise pour identifier de manière unique le gestionnaire de région d’opération uniquement lorsque le pilote annule l’inscription du gestionnaire.

En règle générale, un pilote inscrit un gestionnaire de région d’opération dans la routine de distribution Plug-and-Play du pilote après avoir démarré un FDO en réponse à une demande de IRP_MN_START_DEVICE. Le pilote doit inscrire le gestionnaire après avoir alloué le contexte de région d’opération du gestionnaire. Si le pilote crée une interface de périphérique définie par le fournisseur, il doit activer l’interface de périphérique après avoir inscrit le gestionnaire.

Un pilote de fonction de périphérique ACPI annule l’inscription d’un gestionnaire de région d’opération en appelant DeRegisterOpRegionHandler et en fournissant les informations suivantes :

  • PDO qui représente l’appareil ACPI qui définit la région d’opération.

  • Objet de région d’opération retourné par le pilote ACPI lorsque le pilote a inscrit le gestionnaire de région d’opération. Cet objet identifie de manière unique le gestionnaire de région d’opération.

En règle générale, un pilote annule l’inscription d’un gestionnaire de région d’opération dans la routine de distribution Plug-and-Play du pilote avant qu’il arrête un FDO en réponse à une demande de IRP_MN_STOP_DEVICE. Le pilote doit annuler l’inscription du gestionnaire avant de libérer le contexte de la région d’opération du gestionnaire. Si le pilote crée une interface de périphérique définie par le fournisseur, il doit désactiver l’interface du périphérique avant d’annuler l’inscription du gestionnaire.