Función KsAddObjectCreateItemToObjectHeader (ks.h)

La función KsAddObjectCreateItemToObjectHeader agrega el elemento de creación especificado a un elemento vacío en la lista de elementos de creación asignada previamente para este encabezado de objeto. Un elemento vacío se indica mediante un NULL crear función de distribución en la entrada. Esta función supone que el autor de la llamada está serializando varios cambios en la lista de elementos de creación.

Sintaxis

KSDDKAPI NTSTATUS KsAddObjectCreateItemToObjectHeader(
  [in]           KSOBJECT_HEADER      Header,
  [in]           PDRIVER_DISPATCH     Create,
  [in]           PVOID                Context,
  [in]           PWSTR                ObjectClass,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor
);

Parámetros

[in] Header

Apunta al encabezado de objeto que contiene la tabla de creación secundaria asignada anteriormente.

[in] Create

Especifica la función create dispatch que se va a usar.

[in] Context

Especifica el parámetro de contexto.

[in] ObjectClass

Especifica un puntero a un cadena de caracteres terminada en NULLque se usa para la comparación en las solicitudes de creación. Este puntero debe permanecer válido mientras el objeto está activo.

[in, optional] SecurityDescriptor

Especifica el descriptor de seguridad. Esto debe permanecer válido mientras el objeto está activo.

Valor devuelto

La función KsAddObjectCreateItemToObjectHeader devuelve STATUS_SUCCESS si se encontró una ranura de elemento de creación vacía y se agregó el elemento. Si no se realiza correctamente, devuelve STATUS_ALLOTTED_SPACE_EXCEEDED.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	ks.h (incluya Ks.h)
biblioteca de	Ks.lib