KSOBJECT_CREATE_ITEM Struktur (ks.h)
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;
Angehörige
Create
Enthält die Create Dispatch-Funktion für diese bestimmte Basisobjektklasse. Informationen zur Signatur dieses Funktionstyps finden Sie unter DRIVER_OBJECT.
Context
Verweist auf einen Puffer, der zum Speichern von Objekttypspezifischen Kontextinformationen verwendet werden kann. Weitere Informationen finden Sie im Abschnitt "Hinweise" weiter unten.
ObjectClass
Verweist 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 dies freigegeben werden, wenn der Objekttyp nicht mehr verwendet wird. Dies muss Poolspeicher verwenden und kann nicht freigegeben werden, da er ersetzt werden kann. Wenn dies geändert wird, wird das Flags Element aktualisiert. Wahlfrei.
Flags
Gibt den Anforderungstyp an. Flags können die Werte in der folgenden Tabelle enthalten.
| Flagge | Beschreibung |
|---|---|
| KSCREATE_ITEM_SECURITYCHANGED | Gibt an, dass der Sicherheitsdeskriptor für diesen Objekttyp geändert wurde und beibehalten werden soll. |
| KSCREATE_ITEM_WILDCARD | Gibt an, dass dieses Erstellungselement eine Wildcard darstellt, die für alle Erstellungsanforderungen verwendet wird, die keinem anderen Erstellungselement entsprechen. Die Sortierung des Wildcardeintrags in der Liste der Erstellungselemente ist irrelevant. Nur ein einzelner Wildcardeintrag ist für eine beliebige Liste der erstellungselemente gültig. |
| KSCREATE_ITEM_NOPARAMETERS | Gibt an, dass dieses Erstellungselement die Übergabe von Parametern nicht zulässt und fehlschlägt, wenn eine gefunden wird. Normalerweise werden Erstellungsparameter an den Erstellungshandler übergeben. Dies kann nicht mit einer Wildcardkennzeichnung verwendet werden. |
Bemerkungen
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 mithilfe des KSCREATE_ITEM_IRP_STORAGE-Makros auf diesen Zeiger zugreifen. Dieses Makro und verwandte Makros sind in ks.henthalten.
Der Minidriver ruft diesen Zeiger möglicherweise ab, wenn ein neues Objekt erstellt wird, um das Feld Context zu untersuchen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ks.h (enthalten Ks.h) |