WdfDeviceInitSetRequestAttributes, fonction (wdfdevice.h)

Article
02/07/2025

[S’applique à KMDF et UMDF]

La méthode WdfDeviceInitSetRequestAttributes définit des attributs d’objet qui seront utilisés pour tous les objets de requête de framework que l’infrastructure remet au pilote à partir des files d’attente d’E/S de l’appareil.

Syntaxe

void WdfDeviceInitSetRequestAttributes(
  [in] PWDFDEVICE_INIT        DeviceInit,
  [in] PWDF_OBJECT_ATTRIBUTES RequestAttributes
);

Paramètres

[in] DeviceInit

Pointeur fourni par l’appelant vers une structure WDFDEVICE_INIT.

[in] RequestAttributes

Pointeur vers une structure WDF_OBJECT_ATTRIBUTES allouée par l’appelant qui contient des attributs pour les objets de requête de l’appareil.

Valeur de retour

Aucun

Remarques

Votre pilote peut appeler WdfDeviceInitSetRequestAttributes pour spécifier l’espace de contexte d’objet que l’infrastructure affectera aux objets de requête qu’il crée pour votre pilote. Pour plus d’informations sur cet espace de contexte, consultez Using Request Object Context.

L’infrastructure n’utilise pas les attributs d’objet spécifiés pour les objets de requête qu’il crée lorsqu’un pilote appelle WdfRequestCreate ou WdfRequestCreateFromIrp.

Votre pilote doit appeler WdfDeviceInitSetRequestAttributes à partir de sa fonction de rappel EvtDriverDeviceAdd, avant d’appeler WdfDeviceCreate. Pour plus d’informations, consultez Création d’un objet d’appareil Framework.

Exemples

L’exemple de code suivant initialise une structure de WDF_OBJECT_ATTRIBUTES et appelle WdfDeviceInitSetRequestAttributes.

typedef struct _REQUEST_CONTEXT {
  ULONG_PTR  Information;
} REQUEST_CONTEXT, *PREQUEST_CONTEXT;
WDF_OBJECT_ATTRIBUTES  attributes;

WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
                                        &attributes,
                                        REQUEST_CONTEXT
                                        );
WdfDeviceInitSetRequestAttributes(
                                  DeviceInit,
                                  &attributes
                                  );

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	childDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Voir aussi

EvtDriverDeviceAdd

Partager via