KsAddObjectCreateItemToDeviceHeader-Funktion (ks.h)

Die KsAddObjectCreateItemToDeviceHeader-Funktion fügt das angegebene create-item einem leeren Element in der zuvor zugeordneten Erstellungselementliste für diesen Geräteheader hinzu. Ein leeres Element wird durch eine NULL create dispatch-Funktion im Eintrag gekennzeichnet. Bei dieser Funktion wird davon ausgegangen, dass der Aufrufer mehrere Änderungen an der Liste der Erstellungselemente serialisiert.

Syntax

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

Parameter

[in] Header

Verweist auf den Geräteheader, der die zuvor zugeordnete untergeordnete Create-Tabelle enthält.

[in] Create

Gibt die Create Dispatch-Funktion an.

[in] Context

Gibt den Kontextparameter an.

[in] ObjectClass

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

[in, optional] SecurityDescriptor

Gibt den Sicherheitsdeskriptor an. Dies muss gültig bleiben, während das Geräteobjekt aktiv ist. Dieser Parameter ist optional.

Rückgabewert

Die KsAddObjectCreateItemToDeviceHeader-Funktion gibt STATUS_SUCCESS zurück, wenn ein leerer Erstellungselementslot gefunden und das Element hinzugefügt wurde. Wenn der Fehler nicht erfolgreich ist, wird STATUS_ALLOTTED_SPACE_EXCEEDED zurückgegeben.

Anforderungen