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) |