KSOBJECT_CREATE_ITEM-Struktur (ks.h)

Artikel
02/29/2024

Die KSOBJECT_CREATE_ITEM-Struktur wird verwendet, um die an eine Erstellungsanforderung übergebene Zeichenfolge nachzuschlagen.

Syntax

typedef struct {
  PDRIVER_DISPATCH     Create;
  PVOID                Context;
  UNICODE_STRING       ObjectClass;
  PSECURITY_DESCRIPTOR SecurityDescriptor;
  ULONG                Flags;
} KSOBJECT_CREATE_ITEM, *PKSOBJECT_CREATE_ITEM;

Member

Create

Enthält die Create-Dispatch-Funktion für diese bestimmte Basisobjektklasse. Die Signatur dieses Funktionstyps finden Sie unter DRIVER_OBJECT .

Context

Verweist auf einen Puffer, der zum Speichern objekttypspezifischer Kontextinformationen verwendet werden kann. Weitere Informationen finden Sie im Abschnitt Hinweise unten.

ObjectClass

Zeigt auf eine Unicode-Zeichenfolge, die die Objektklasse identifiziert. Dies ist die Zeichenfolge, die zum Registrieren bei PnP für eine bestimmte Objektklasse verwendet wurde, die von diesem Gerät unterstützt wird.

SecurityDescriptor

Enthält einen Zeiger auf eine SECURITY_DESCRIPTOR für diesen Objekttyp, andernfalls NULL. Wenn Sicherheit verwendet wird, muss diese freigegeben werden, wenn der Objekttyp nicht mehr verwendet wird. Dies muss Poolspeicher verwenden und kann nicht freigegeben werden, da er möglicherweise ersetzt werden kann. Wenn dies geändert wird, wird das Flags-Element aktualisiert. Optional.

Flags

Gibt den Anforderungstyp an. Für Flags können die Werte in der folgenden Tabelle aufgeführt sein.

Flag	Beschreibung
KSCREATE_ITEM_SECURITYCHANGED	Gibt an, dass die Sicherheitsbeschreibung für diesen Objekttyp geändert wurde und beibehalten werden sollte.
KSCREATE_ITEM_WILDCARD	Gibt an, dass dieses Create-Element einen wilden Karte darstellt, der für alle Erstellungsanforderungen verwendet wird, die nicht mit anderen Erstellungselementen übereinstimmen. Die Reihenfolge des Karte Eintrags in der Liste der Erstellungselemente ist irrelevant. Nur ein einzelner Karte Eintrag ist für eine Liste von Erstellungselementen gültig.
KSCREATE_ITEM_NOPARAMETERS	Gibt an, dass dieses Erstellungselement das Übergeben von Parametern nicht zulässt, und schlägt fehl, wenn welche gefunden werden. Normalerweise werden Create-Parameter an den Create-Handler übergeben. Dies kann nicht mit einem wilden Karte Flag verwendet werden.

Hinweise

Ein Zeiger auf die KSOBJECT_CREATE_ITEM-Struktur wird im DriverContext-Member von Irp-Tail.Overlay> platziert, bevor das Objekt erstellt wird. Sie können auf diesen Zeiger zugreifen, indem Sie das Makro KSCREATE_ITEM_IRP_STORAGE verwenden. Dieses Makro und verwandte Makros sind in ks.h enthalten.

Der Minidriver kann diesen Zeiger abrufen, wenn ein neues Objekt erstellt wird, um das Feld Kontext zu untersuchen.