KsAddObjectCreateItemToDeviceHeader, fonction (ks.h)

La fonction KsAddObjectCreateItemToDeviceHeader ajoute l’élément create-item 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 une fonction de dispatch create NULL dans l’entrée. Cette fonction suppose que l’appelant sérialise plusieurs modifications apportées à 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 d’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 terminée par NULL qui sera utilisée pour la comparaison sur les demandes de création. Ce pointeur doit rester valide tant que l’objet d’appareil est actif.

[in, optional] SecurityDescriptor

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

Valeur renvoyée

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

Configuration requise