Funzione KsAllocateObjectCreateItem (ks.h)
La funzione KsAllocateObjectCreateItem alloca anche uno slot per l'elemento di creazione specificato, allocando facoltativamente spazio per e copiando i dati dell'elemento di creazione. Questa funzione presuppone che il chiamante serializzi più modifiche all'elenco di voci di creazione.
Sintassi
KSDDKAPI NTSTATUS KsAllocateObjectCreateItem(
[in] KSDEVICE_HEADER Header,
[in] PKSOBJECT_CREATE_ITEM CreateItem,
[in] BOOLEAN AllocateEntry,
[in, optional] PFNKSITEMFREECALLBACK ItemFreeCallback
);
Parametri
[in] Header
Punta all'intestazione del dispositivo in cui collegare l'elemento di creazione.
[in] CreateItem
Contiene l'elemento di creazione da collegare.
[in] AllocateEntry
Indica se il puntatore all'elemento creato deve essere collegato direttamente all'intestazione o se deve essere eseguita una copia.
[in, optional] ItemFreeCallback
Facoltativamente, contiene un puntatore a una funzione KStrItemFreeCallback definita da minidriver da chiamare quando la voce di creazione viene eliminata quando libera l'intestazione del dispositivo. Questa operazione è valida solo quando AllocateEntry è TRUE.
Valore restituito
Restituisce STATUS_SUCCESS se è stato allocato e collegato un nuovo elemento. In caso contrario, restituisce STATUS_INSUFFICIENT_RESOURCES.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | ks.h (include Ks.h) |
| Libreria | Ks.lib |