PsCreateSiloContext, fonction (ntddk.h)

  • Article

Cette routine crée un objet qui sera inséré dans un Silo.

Syntaxe

NTSTATUS PsCreateSiloContext(
  [in]           PESILO                        Silo,
  [in]           ULONG                         Size,
  [in]           POOL_TYPE                     PoolType,
  [in, optional] SILO_CONTEXT_CLEANUP_CALLBACK ContextCleanupCallback,
                 PVOID                         *ReturnedSiloContext
);

Paramètres

[in] Silo

Pointeur vers un silo.  Ce paramètre est obligatoire et ne peut pas être NULL.

[in] Size

Taille, en octets, de la partie de l’objet définie par l’appelant.

[in] PoolType

Type de pool à partir duquel allouer. Ce paramètre est obligatoire et doit être l’un des éléments suivants : NonPagedPoolNx ou PagedPool.

[in, optional] ContextCleanupCallback

Pointeur vers une fonction de rappel SILO_CONTEXT_CLEANUP_CALLBACK . La fonction est appelée lorsque l’objet retourné n’a aucune référence à celle-ci. Ce paramètre est facultatif et peut être NULL.

ReturnedSiloContext

Pointeur vers une variable allouée par l’appelant qui reçoit l’adresse de l’objet nouvellement créé.

Valeur retournée

Les codes de status NT suivants sont retournés.

Code de retour Description
STATUS_INSUFFICIENT_RESOURCES La routine a rencontré un échec d’allocation de pool. Il s’agit d’un code d’erreur.
STATUS_INVALID_PARAMETER Le type de pool n’est pas valide. Il s’agit d’un code d’erreur.
STATUS_SUCCESS L’opération s’est terminée avec succès.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1607
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Windows
En-tête ntddk.h