KsAddObjectCreateItemToObjectHeader-Funktion (ks.h)

Die KsAddObjectCreateItemToObjectHeader Funktion fügt das angegebene Erstellungselement einem leeren Element in der zuvor zugewiesenen Objektkopfzeile zum Erstellen einer Elementliste hinzu. Ein leeres Element ist durch eine NULL- Erstellen einer Verteilerfunktion im Eintrag gekennzeichnet. Bei dieser Funktion wird davon ausgegangen, dass der Aufrufer mehrere Änderungen an der Listen zum Erstellen von Elementen serialisiert.

Syntax

KSDDKAPI NTSTATUS KsAddObjectCreateItemToObjectHeader(
  [in]           KSOBJECT_HEADER      Header,
  [in]           PDRIVER_DISPATCH     Create,
  [in]           PVOID                Context,
  [in]           PWSTR                ObjectClass,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor
);

Parameter

[in] Header

Verweist auf die Objektkopfzeile, die die zuvor zugeordnete untergeordnete Tabelle enthält.

[in] Create

Gibt die zu verwendende Create Dispatch-Funktion an.

[in] Context

Gibt den Kontextparameter an.

[in] ObjectClass

Gibt einen Zeiger auf eine NULL--terminated-Zeichenfolge an, die für den Vergleich bei Erstellungsanforderungen verwendet wird. Dieser Zeiger muss gültig bleiben, während das Objekt aktiv ist.

[in, optional] SecurityDescriptor

Gibt den Sicherheitsdeskriptor an. Dies muss gültig bleiben, während das Objekt aktiv ist.

Rückgabewert

Die KsAddObjectCreateItemToObjectHeader Funktion gibt STATUS_SUCCESS zurück, wenn ein leerer Elementplatz gefunden und das Element hinzugefügt wurde. Wenn dies nicht erfolgreich ist, wird STATUS_ALLOTTED_SPACE_EXCEEDED zurückgegeben.

Anforderungen