Fonction WdfDeviceSetPnpCapabilities (wdfdevice.h)

Article
02/07/2025

[S’applique à KMDF et UMDF]

La méthode WdfDeviceSetPnpCapabilities signale les fonctionnalités Plug-and-Play d’un appareil.

Syntaxe

void WdfDeviceSetPnpCapabilities(
  [in] WDFDEVICE                    Device,
  [in] PWDF_DEVICE_PNP_CAPABILITIES PnpCapabilities
);

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

[in] PnpCapabilities

Pointeur vers une structure WDF_DEVICE_PNP_CAPABILITIES allouée par le pilote.

Valeur de retour

Aucun

Remarques

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Un pilote appelle généralement WdfDeviceSetPnpCapabilities à partir de l’une des fonctions de rappel suivantes :

EvtDriverDeviceAdd
EvtDevicePrepareHardware
EvtDeviceD0Entry (si la valeur du paramètre PreviousState est WdfPowerDeviceD3Final)
EvtDeviceSelfManagedIoInit
EvtChildListCreateDevice

Si plusieurs pilotes de la pile de pilotes de l’appareil appellent WdfDeviceSetPnpCapabilities, le gestionnaire Plug-and-Play utilise les valeurs fournies par le pilote le plus élevé dans la pile.

Exemples

Les exemples de code suivants initialisent une structure de WDF_DEVICE_PNP_CAPABILITIES, puis appellent WdfDeviceSetPnpCapabilities.

WDF_DEVICE_PNP_CAPABILITIES  pnpCaps;

WDF_DEVICE_PNP_CAPABILITIES_INIT(&pnpCaps);
pnpCaps.SurpriseRemovalOK = WdfTrue;

WdfDeviceSetPnpCapabilities(
                            device,
                            &pnpCaps
                            );

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	wdfdevice.h (include Wdf.h)
bibliothèque	Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WDF_DEVICE_PNP_CAPABILITIES

WDF_DEVICE_PNP_CAPABILITIES_INIT

WdfDeviceSetPowerCapabilities

Partager via