ALLOCATE_SHARED_MEMORY_HANDLER fonction de rappel (ndis.h)

Article
02/29/2024

La fonction NetAllocateSharedMemory (ALLOCATE_SHARED_MEMORY_HANDLER point d’entrée) est appelée par NDIS lorsqu’un pilote alloue de la mémoire partagée à partir d’un fournisseur de mémoire partagée.

Syntaxe

ALLOCATE_SHARED_MEMORY_HANDLER AllocateSharedMemoryHandler;

NDIS_STATUS AllocateSharedMemoryHandler(
  [in]      NDIS_HANDLE ProviderContext,
  [in]      PNDIS_SHARED_MEMORY_PARAMETERS SharedMemoryParameters,
  [in, out] PNDIS_HANDLE pSharedMemoryProviderContext
)
{...}

Paramètres

[in] ProviderContext

Une NDIS_HANDLE à un bloc d’informations de contexte allouées par le pilote qui identifie le fournisseur. Le fournisseur a fourni ces informations dans le membre ProviderContext du NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS structure.

[in] SharedMemoryParameters

Pointeur vers un NDIS_SHARED_MEMORY_PARAMETERS structure qui définit les attributs demandés pour la mémoire partagée.

[in, out] pSharedMemoryProviderContext

Pointeur vers un handle pour une zone de contexte de mémoire partagée. Le fournisseur de mémoire partagée fournit un handle qui identifie la mémoire partagée qu’il a allouée.

Valeur retournée

NetAllocateSharedMemory peut retourner les valeurs status suivantes :

Code de retour	Description
NDIS_STATUS_SUCCESS	L’opération s’est terminée avec succès.
NDIS_STATUS_RESOURCES	L’opération a échoué, car les ressources étaient insuffisantes pour terminer l’opération.
NDIS_STATUS_INVALID_PARAMETER	L’opération a échoué en raison d’un paramètre d’entrée non valide.
NDIS_STATUS_FAILURE	L’opération a échoué pour des raisons non spécifiées.

Remarques

NDIS appelle la fonction NetAllocateSharedMemory d’un fournisseur de mémoire partagée lorsqu’un pilote appelle le Fonction NdisAllocateSharedMemory .

Le fournisseur de mémoire partagée a spécifié le point d’entrée (ALLOCATE_SHARED_MEMORY_HANDLER) pour NetAllocateSharedMemory dans le NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS structure.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.20 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ndis.h (inclure Ndis.h)
IRQL	PASSIVE_LEVEL

Voir aussi

NDIS_SHARED_MEMORY_PARAMETERS

NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS

NdisAllocateSharedMemory

Partager via