struttura WDF_OBJECT_CONTEXT_TYPE_INFO (wdfobject.h)

Articolo
08/08/2023

[Si applica a KMDF e UMDF]

La struttura WDF_OBJECT_CONTEXT_TYPE_INFO descrive la memoria del contesto definita dal driver di un oggetto framework.

Sintassi

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;

Members

Size

Dimensione, in byte, della struttura.

ContextName

Stringa tra virgolette che rappresenta il nome di una struttura definita dal driver che contiene le informazioni di contesto di un oggetto.

ContextSize

Dimensione, in byte, della struttura specificata dal membro ContextName . Il framework alloca spazio per questa struttura quando crea un oggetto . Se il membro ContextSizeOverride della struttura WDF_OBJECT_ATTRIBUTES è diverso da zero, il relativo valore esegue l'override del valore nel membro ContextSize .

UniqueType

Per uso interno.

EvtDriverGetUniqueContextType

Per uso interno.

Commenti

Per ogni istanza dell'oggetto, il framework alloca la memoria del contesto con una dimensione basata sul valore del membro ContextSize o sul valore del membro ContextSizeOverride della struttura WDF_OBJECT_ATTRIBUTES .

Per creare e inizializzare una struttura di WDF_OBJECT_CONTEXT_TYPE_INFO, i driver devono utilizzare la macro WDF_DECLARE_CONTEXT_TYPE o la macro WDF_DECLARE_CONTEXT_TYPE_WITH_NAME .

Per inserire un puntatore a questa struttura in una struttura WDF_OBJECT_ATTRIBUTES, i driver devono utilizzare la macro WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE .

Per altre informazioni sull'uso di queste macro, vedere Framework Object Context Space.