Freigeben über


KsAllocateObjectCreateItem-Funktion (ks.h)

Die KsAllocateObjectCreateItem-Funktion weist einen Slot für das angegebene Erstellungselement zu, wobei optional Speicherplatz für die Erstellungselementdaten zugewiesen und kopiert wird. Bei dieser Funktion wird davon ausgegangen, 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

Zeigt auf den Geräteheader, an den das Create-Element angefügt werden soll.

[in] CreateItem

Enthält das anzufügende Element zum Erstellen.

[in] AllocateEntry

Gibt an, ob der übergebene Zeiger des Create-Elements direkt an den Header angefügt werden soll oder ob stattdessen eine Kopie davon erstellt werden soll.

[in, optional] ItemFreeCallback

Enthält optional einen Zeiger auf eine minidriver-definierte KStrItemFreeCallback-Funktion , die aufgerufen werden soll, wenn der Create-Eintrag beim Freigeben des Geräteheaders zerstört wird. Dies ist nur gültig, wenn AllocateEntrytrue ist.

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 Universell
Header ks.h (einschließlich Ks.h)
Bibliothek Ks.lib

Weitere Informationen

KStrItemFreeCallback