KsAllocateObjectCreateItem-Funktion (ks.h)

Artikel
02/07/2025

Die KsAllocateObjectCreateItem--Funktion weist einen Steckplatz für das angegebene Erstellungselement zu, wobei optional Platz für die Erstellung von Elementdaten zugewiesen und kopiert wird. Diese Funktion geht davon aus, dass der Aufrufer mehrere Änderungen an der Erstellungseintragsliste serialisiert.

Syntax

KSDDKAPI NTSTATUS KsAllocateObjectCreateItem(
  [in]           KSDEVICE_HEADER       Header,
  [in]           PKSOBJECT_CREATE_ITEM CreateItem,
  [in]           BOOLEAN               AllocateEntry,
  [in, optional] PFNKSITEMFREECALLBACK ItemFreeCallback
);

Parameter

[in] Header

Verweist auf den Gerätekopf, an dem das Erstellungselement angefügt werden soll.

[in] CreateItem

Enthält das zu anfügende Erstellungselement.

[in] AllocateEntry

Gibt an, ob der übergebene Elementzeiger direkt an die Kopfzeile angefügt werden soll oder ob stattdessen eine Kopie davon erstellt werden soll.

[in, optional] ItemFreeCallback

Enthält optional einen Zeiger auf einen minidriver-definierten KStrItemFreeCallback--Funktion, die aufgerufen werden soll, wenn der Erstellungseintrag beim Freigeben der Gerätekopfzeile zerstört wird. Dies ist nur gültig, wenn AllocateEntry-TRUEist.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn ein neues Element zugewiesen und angefügt wurde. Andernfalls wird STATUS_INSUFFICIENT_RESOURCES zurückgegeben.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ks.h (enthalten Ks.h)
Library	Ks.lib

Siehe auch

KStrItemFreeCallback-

Freigeben über