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 |