KsCreateAllocator, fonction (ks.h)
La fonction KsCreateAllocator crée un handle à un allocator pour le handle de connexion récepteur donné. Cette fonction ne termine pas l’IRP ou ne définit pas l’état 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 du récepteur sur laquelle créer l’allocateur.
[in] AllocatorFraming
Cadre spécifié pour l’allocateur.
[out] AllocatorHandle
Spécifie le pointeur vers un handle pour stocker le handle d’allocator.
Valeur de retour
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 : une pour les clients en mode utilisateur et une pour les clients en mode noyau. Cette fonction ne peut être appelée qu’à PASSIVE_LEVEL pour les clients en mode noyau.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |
| IRQL | PASSIVE_LEVEL (voir la section Remarques) |