WdfPdoInitAssignRawDevice, fonction (wdfpdo.h)

  • Article

[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)

Voir aussi

WdfDeviceInitAssignSDLString

WdfDeviceInitSetCharacteristics

WdfDeviceInitSetDeviceType

WdfDeviceInitSetExclusive