WdfPdoInitAssignRawDevice, fonction (wdfpdo.h)
[S’applique à KMDF uniquement]
La méthode WdfPdoInitAssignRawDevice indique que le pilote appelant peut prendre en charge un appareil spécifié en mode brut.
Syntaxe
NTSTATUS WdfPdoInitAssignRawDevice(
[in] PWDFDEVICE_INIT DeviceInit,
[in] const GUID *DeviceClassGuid
);
Paramètres
[in] DeviceInit
Pointeur vers une structure WDFDEVICE_INIT .
[in] DeviceClassGuid
Pointeur vers un GUID qui identifie une classe d’installation d’appareil.
Note Vous devez toujours spécifier un GUID de classe personnalisé. Vous ne devez pas spécifier un GUID de classe existant. Si vous spécifiez un GUID de classe existant, d’autres pilotes qui tentent de spécifier ce GUID de classe existant peuvent ne pas être installés ou installer avec des paramètres de sécurité incorrects.
Pour plus d'informations, consultez la section Notes qui suit.
Valeur retournée
Si l’opération réussit, la méthode retourne STATUS_SUCCESS. Sinon, elle retourne STATUS_INVALID_PARAMETER.
Remarques
Le pilote doit appeler WdfPdoInitAssignRawDevice avant d’appeler WdfDeviceCreate. Pour plus d’informations sur l’appel de WdfDeviceCreate, consultez Création d’un objet d’appareil framework.
Le Registre peut contenir des valeurs qui remplacent les valeurs spécifiées par un pilote lorsqu’il appelle WdfDeviceInitAssignSDDLString, WdfDeviceInitSetDeviceType, WdfDeviceInitSetCharacteristics et WdfDeviceInitSetExclusive. Le paramètre DeviceClassGuid de la méthode WdfPdoInitAssignRawDevice spécifie un GUID qui identifie la section du Registre qui contient les valeurs de remplacement. Le paramètre DeviceClassGuid identifie uniquement une section du Registre et ne définit pas réellement la classe de configuration de l’appareil. La section Version INF du fichier INF de votre appareil et de votre pilote définit la classe d’installation de périphérique. En règle générale, le GUID du paramètre DeviceClassGuid doit correspondre au GUID spécifié dans la section Version INF .
Pour plus d’informations sur l’utilisation du Registre, consultez Définition des propriétés du registre d’objets d’appareil après l’installation.
Exemples
L’extrait de code suivant de l’exemple de pilote kmdf_enumswitches indique qu’un pilote peut prendre en charge l’appareil spécifié en mode brut.
NTSTATUS status;
DEFINE_GUID(GUID_DEVCLASS_MYUNIQUEID,
0xf149fe88, 0x f6cc, 0x47e3, 0x85, 0x94, 0xe2, 0xaa, 0xb6, 0xe0, 0x3b, 0xdf);
status = WdfPdoInitAssignRawDevice(
pDeviceInit,
&GUID_DEVCLASS_MYUNIQUEID
);
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| En-tête | wdfpdo.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).) |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | ChildDeviceInitAPI(kmdf), DriverCreate(kmdf), InitFreeDeviceCallback(kmdf), InitFreeDeviceCreate(kmdf), InitFreeNull(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf), PdoInitFreeDeviceCallback(kmdf), PdoInitFreeDeviceCreate(kmdf) |