KsAllocateObjectCreateItem, fonction (ks.h)

La fonction KsAllocateObjectCreateItem alloue 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 création d’élément. Cette fonction suppose que l’appelant sérialise plusieurs modifications apportées à 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 à attacher.

[in] AllocateEntry

Indique si le pointeur de création d’élément transmis doit être attaché directement à l’en-tête ou si une copie de celui-ci doit être effectuée à la place.

[in, optional] ItemFreeCallback

Contient éventuellement un pointeur vers une fonction KStrItemFreeCallback définie par minidriver à appeler lorsque l’entrée de création est détruite lors de la libération de l’en-tête de l’appareil. Cette option n’est valide que si AllocateEntry a lavaleur TRUE.

Valeur retournée

Retourne STATUS_SUCCESS si un nouvel élément a été alloué et attaché. Sinon, il retourne STATUS_INSUFFICIENT_RESOURCES.

Configuration requise

Voir aussi

KStrItemFreeCallback