Función KsAddObjectCreateItemToDeviceHeader (ks.h)

  • Artículo

La función KsAddObjectCreateItemToDeviceHeader agrega el elemento create-item especificado a un elemento vacío en la lista de elementos de creación asignada previamente para este encabezado de dispositivo. Un elemento vacío se indica mediante una función de envío create NULL 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 KsAddObjectCreateItemToDeviceHeader(
  [in]           KSDEVICE_HEADER      Header,
  [in]           PDRIVER_DISPATCH     Create,
  [in]           PVOID                Context,
  [in]           PWSTR                ObjectClass,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor
);

Parámetros

[in] Header

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

[in] Create

Especifica la función create dispatch.

[in] Context

Especifica el parámetro de contexto.

[in] ObjectClass

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

[in, optional] SecurityDescriptor

Especifica el descriptor de seguridad. Esto debe permanecer válido mientras el objeto de dispositivo está activo. Este parámetro es opcional.

Valor devuelto

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

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado ks.h (incluye Ks.h)
Library Ks.lib