WDF_OBJECT_CONTEXT_TYPE_INFO structure (wdfobject.h)

Article
02/27/2024

[S’applique à KMDF et UMDF]

La structure WDF_OBJECT_CONTEXT_TYPE_INFO décrit la mémoire de contexte définie par le pilote d’un objet framework.

Syntaxe

typedef struct _WDF_OBJECT_CONTEXT_TYPE_INFO {
  ULONG                          Size;
  LPCSTR                         ContextName;
  size_t                         ContextSize;
  PCWDF_OBJECT_CONTEXT_TYPE_INFO UniqueType;
  PFN_GET_UNIQUE_CONTEXT_TYPE    EvtDriverGetUniqueContextType;
} WDF_OBJECT_CONTEXT_TYPE_INFO, *PWDF_OBJECT_CONTEXT_TYPE_INFO;

Membres

Size

Taille, en octets, de cette structure.

ContextName

Chaîne entre guillemets qui représente le nom d’une structure définie par le pilote qui contient les informations de contexte d’un objet.

ContextSize

Taille, en octets, de la structure spécifiée par le membre ContextName . L’infrastructure alloue de l’espace pour cette structure lorsqu’elle crée un objet. Si le membre ContextSizeOverride de la structure WDF_OBJECT_ATTRIBUTES est différent de zéro, sa valeur remplace la valeur dans le membre ContextSize .

UniqueType

À usage interne uniquement.

EvtDriverGetUniqueContextType

À usage interne uniquement.

Notes

Pour chaque objet instance, l’infrastructure alloue de la mémoire contextuelle avec une taille basée sur la valeur du membre ContextSize ou la valeur du membre ContextSizeOverride de la structure WDF_OBJECT_ATTRIBUTES.

Pour créer et initialiser une structure WDF_OBJECT_CONTEXT_TYPE_INFO, les pilotes doivent utiliser la macro WDF_DECLARE_CONTEXT_TYPE ou la macro WDF_DECLARE_CONTEXT_TYPE_WITH_NAME .

Pour insérer un pointeur vers cette structure dans une structure WDF_OBJECT_ATTRIBUTES, les pilotes doivent utiliser la macro WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE .

Pour plus d’informations sur l’utilisation de ces macros, consultez Framework Object Context Space.