WdfDeviceInitSetExclusive, fonction (wdfdevice.h)

  • Article

[S’applique à KMDF uniquement]

La méthode WdfDeviceInitSetExclusive indique si un appareil spécifié est un appareil exclusif.

Syntaxe

void WdfDeviceInitSetExclusive(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] BOOLEAN         IsExclusive
);

Paramètres

[in] DeviceInit

Pointeur vers une structure WDFDEVICE_INIT .

[in] IsExclusive

Valeur booléenne qui, si elle est TRUE, indique que l’appareil est un appareil exclusif. Si la valeur est FALSE, l’appareil n’est pas un appareil exclusif.

Valeur de retour

None

Remarques

Si un pilote appelle WdfDeviceInitSetExclusive, il doit le faire avant d’appeler WdfDeviceCreate.

Si un pilote appelle WdfDeviceInitSetExclusive, seul l’objet de périphérique de ce pilote est exclusif. Pour rendre l’intégralité de la pile d’appareils d’un appareil exclusive, le fichier INF de l’appareil doit inclure une directive INF AddReg qui définit une entrée exclusive sur TRUE dans le Registre.

Pour plus d’informations sur l’appel de WdfDeviceCreate, consultez Création d’un objet d’appareil framework.

Si vous écrivez un pilote UMDF, vous devez modifier le fichier INF de votre pilote ou apporter des modifications au Registre pour indiquer si l’appareil est exclusif. Pour plus d’informations sur l’utilisation du Registre, consultez Définition des propriétés du registre d’objets d’appareil pendant l’installation.

Exemples

L’exemple de code suivant indique qu’un appareil est un appareil exclusif.

WdfDeviceInitSetExclusive(
                          DeviceInit,
                          TRUE
                          );

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdfdevice.h (inclure Wdf.h)
Bibliothèque Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).)
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Voir aussi

EvtDriverDeviceAdd

WdfDeviceCreate