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

Vedi anche

KStrItemFreeCallback