Función KsAllocateObjectCreateItem (ks.h)
La función KsAllocateObjectCreateItem asigna una ranura para el elemento de creación especificado, asignando opcionalmente espacio para y copiando también los datos del elemento de creación. Esta función supone que el autor de la llamada está serializando varios cambios en la lista de entradas de creación.
Sintaxis
KSDDKAPI NTSTATUS KsAllocateObjectCreateItem(
[in] KSDEVICE_HEADER Header,
[in] PKSOBJECT_CREATE_ITEM CreateItem,
[in] BOOLEAN AllocateEntry,
[in, optional] PFNKSITEMFREECALLBACK ItemFreeCallback
);
Parámetros
[in] Header
Apunta al encabezado del dispositivo en el que se va a adjuntar el elemento de creación.
[in] CreateItem
Contiene el elemento de creación que se va a adjuntar.
[in] AllocateEntry
Indica si el puntero de creación de elemento pasado debe adjuntarse directamente al encabezado, o si se debe realizar una copia de él en su lugar.
[in, optional] ItemFreeCallback
Opcionalmente, contiene un puntero a una función KStrItemFreeCallback definida por el minidriver que se va a llamar cuando se destruye la entrada de creación al liberar el encabezado del dispositivo. Esto solo es válido cuando AllocateEntry es TRUE.
Valor devuelto
Devuelve STATUS_SUCCESS si se asignó y adjuntó un nuevo elemento. De lo contrario, devuelve STATUS_INSUFFICIENT_RESOURCES.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluye Ks.h) |
| Library | Ks.lib |