WDF_OBJECT_CONTEXT_TYPE_INFO-Struktur (wdfobject.h)

[Gilt für KMDF und UMDF]

Die WDF_OBJECT_CONTEXT_TYPE_INFO-Struktur beschreibt den treiberdefinierte Kontextspeicher eines Frameworkobjekts.

Syntax

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;

Member

Size

Die Größe (in Bytes) dieser Struktur.

ContextName

Eine Zeichenfolge in Anführungszeichen, die den Namen einer vom Treiber definierten Struktur darstellt, die die Kontextinformationen eines Objekts enthält.

ContextSize

Die Größe der Struktur in Bytes, die vom ContextName-Element angegeben wird. Das Framework weist platz für diese Struktur zu, wenn es ein -Objekt erstellt. Wenn der ContextSizeOverride-Member der WDF_OBJECT_ATTRIBUTES-Struktur ungleich null ist, überschreibt sein Wert den Wert im ContextSize-Element .

UniqueType

Für die interne Verwendung.

EvtDriverGetUniqueContextType

Für die interne Verwendung.

Bemerkungen

Für jedes Objekt instance ordnet das Framework Kontextspeicher mit einer Größe zu, die auf dem Wert des ContextSize-Elements oder dem Wert des ContextSizeOverride-Elements der WDF_OBJECT_ATTRIBUTES-Struktur basiert.

Um eine WDF_OBJECT_CONTEXT_TYPE_INFO-Struktur zu erstellen und zu initialisieren, sollten Treiber entweder das Makro WDF_DECLARE_CONTEXT_TYPE oder das Makro WDF_DECLARE_CONTEXT_TYPE_WITH_NAME verwenden.

Um einen Zeiger auf diese Struktur in eine WDF_OBJECT_ATTRIBUTES-Struktur einzufügen, sollten Treiber das Makro WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE verwenden.

Weitere Informationen zur Verwendung dieser Makros finden Sie unter Framework Object Context Space.For more information about using these macros, see Framework Object Context Space.

Anforderungen

Anforderung	Wert
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfobject.h (einschließen von Wdf.h)

Weitere Informationen

WDF_DECLARE_CONTEXT_TYPE

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE