KsAllocateObjectCreateItem, fonction (ks.h)
La fonction KsAllocateObjectCreateItem alloue également un emplacement pour l’élément de création spécifié, en allouant éventuellement de l’espace pour et en copiant également les données de l’élément de création. Cette fonction suppose que l’appelant sérialise plusieurs modifications dans la liste d’entrées de création.
Syntaxe
KSDDKAPI NTSTATUS KsAllocateObjectCreateItem(
[in] KSDEVICE_HEADER Header,
[in] PKSOBJECT_CREATE_ITEM CreateItem,
[in] BOOLEAN AllocateEntry,
[in, optional] PFNKSITEMFREECALLBACK ItemFreeCallback
);
Paramètres
[in] Header
Pointe vers l’en-tête de l’appareil sur lequel attacher l’élément de création.
[in] CreateItem
Contient l’élément de création à joindre.
[in] AllocateEntry
Indique si le pointeur de création d’élément passé doit être attaché directement à l’en-tête, ou si une copie doit être effectuée à la place.
[in, optional] ItemFreeCallback
Contient éventuellement un pointeur vers un minidriver défini KStrItemFreeCallback fonction à appeler lorsque l’entrée de création est détruite lors de la libération de l’en-tête de l’appareil. Cela n’est valide que lorsque AllocateEntry est TRUE.
Valeur de retour
Retourne STATUS_SUCCESS si un nouvel élément a été alloué et attaché. Sinon, elle retourne STATUS_INSUFFICIENT_RESOURCES.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |