WdfDeviceInitSetExclusive, fonction (wdfdevice.h)
[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) |