KsAddObjectCreateItemToDeviceHeader, fonction (ks.h)

La fonction KsAddObjectCreateItemToDeviceHeader ajoute l’élément de création spécifié à un élément vide dans la liste d’éléments de création précédemment allouée pour cet en-tête d’appareil. Un élément vide est indiqué par un NULL créer une fonction de répartition dans l’entrée. Cette fonction suppose que l’appelant sérialise plusieurs modifications dans la liste des éléments de création.

Syntaxe

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

Paramètres

[in] Header

Pointe vers l’en-tête de l’appareil qui contient la table de création enfant précédemment allouée.

[in] Create

Spécifie la fonction create dispatch.

[in] Context

Spécifie le paramètre de contexte.

[in] ObjectClass

Spécifie un pointeur vers une chaîne de caractères null NULL-terminated character qui sera utilisée pour la comparaison sur les demandes de création. Ce pointeur doit rester valide pendant que l’objet de l’appareil est actif.

[in, optional] SecurityDescriptor

Spécifie le descripteur de sécurité. Cela doit rester valide pendant que l’objet de l’appareil est actif. Ce paramètre est facultatif.

Valeur de retour

La fonction KsAddObjectCreateItemToDeviceHeader retourne STATUS_SUCCESS si un emplacement d’élément de création vide a été trouvé et que l’élément a été ajouté. En cas d’échec, elle retourne STATUS_ALLOTTED_SPACE_EXCEEDED.

Exigences