Funzione KsAllocateObjectCreateItem (ks.h)
La funzione KsAllocateObjectCreateItem alloca uno slot per l'elemento di creazione specificato, allocando facoltativamente lo spazio per e copiando anche i dati di creazione dell'elemento. 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 allegare.
[in] AllocateEntry
Indica se il puntatore all'elemento di creazione deve essere collegato direttamente all'intestazione o se deve essere eseguita una copia.
[in, optional] ItemFreeCallback
Facoltativamente, contiene un puntatore a un minidriver definito funzione KStrItemFreeCallback da chiamare quando la voce di creazione viene eliminata definitivamente dopo aver liberato l'intestazione del dispositivo. Questa opzione è valida solo quando AllocateEntry è TRUE.
Valore restituito
Restituisce STATUS_SUCCESS se un nuovo elemento è stato allocato e collegato. In caso contrario, restituisce STATUS_INSUFFICIENT_RESOURCES.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| intestazione | ks.h (include Ks.h) |
| libreria | Ks.lib |