Partager via


KsCreateAllocator, fonction (ks.h)

La fonction KsCreateAllocator crée un handle dans un allocator pour le handle de connexion du récepteur donné. Cette fonction ne termine pas l’IRP ni ne définit le status dans l’IRP.

Syntaxe

KSDDKAPI NTSTATUS KsCreateAllocator(
  [in]  HANDLE               ConnectionHandle,
  [in]  PKSALLOCATOR_FRAMING AllocatorFraming,
  [out] PHANDLE              AllocatorHandle
);

Paramètres

[in] ConnectionHandle

Spécifie le handle de la connexion récepteur sur laquelle créer l’allocateur.

[in] AllocatorFraming

Cadrage spécifié pour l’allocateur.

[out] AllocatorHandle

Spécifie le pointeur vers un handle pour stocker le handle d’allocator.

Valeur retournée

La fonction KsCreateAllocator retourne STATUS_SUCCESS si elle réussit, ou renvoie une erreur en cas d’échec.

Remarques

Il existe deux versions de la fonction KsCreateAllocator : l’une pour les clients en mode utilisateur et l’autre pour les clients en mode noyau. Cette fonction ne peut être appelée qu’à PASSIVE_LEVEL pour les clients en mode noyau.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête ks.h (inclure Ks.h)
Bibliothèque Ks.lib
IRQL PASSIVE_LEVEL (voir la section Remarques)

Voir aussi

KSALLOCATOR_FRAMING