WdfDeviceInitSetRequestAttributes, fonction (wdfdevice.h)

Article
02/29/2024

[S’applique à KMDF et UMDF]

La méthode WdfDeviceInitSetRequestAttributes définit les attributs d’objet qui seront utilisés pour tous les objets de requête d’infrastructure 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 de WDF_OBJECT_ATTRIBUTES allouée par l’appelant qui contient des attributs pour les objets de requête de l’appareil.

Valeur de retour

None

Remarques

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

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

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
Version UMDF minimale	2.0
En-tête	wdfdevice.h (inclure 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