ALLOCATE_SHARED_MEMORY_HANDLER fonction de rappel (ndis.h)
La fonction NetAllocateSharedMemory (point d’entrée ALLOCATE_SHARED_MEMORY_HANDLER) est appelée par NDIS lorsqu’un pilote alloue de la mémoire partagée à partir d’un fournisseur de mémoire partagée.
ALLOCATE_SHARED_MEMORY_HANDLER AllocateSharedMemoryHandler;
NDIS_STATUS AllocateSharedMemoryHandler(
[in] NDIS_HANDLE ProviderContext,
[in] PNDIS_SHARED_MEMORY_PARAMETERS SharedMemoryParameters,
[in, out] PNDIS_HANDLE pSharedMemoryProviderContext
)
{...}
[in] ProviderContext
Un NDIS_HANDLE à un bloc d’informations contextuelles allouées par le pilote qui identifie le fournisseur. Le fournisseur a fourni ces informations dans le ProviderContext membre du structure NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS.
[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.
NetAllocateSharedMemory pouvez retourner les valeurs d’état suivantes :
| Retourner le code | Description |
|---|---|
|
L’opération s’est terminée avec succès. |
|
L’opération a échoué, car il y avait des ressources insuffisantes pour terminer l’opération. |
|
L’opération a échoué en raison d’un paramètre d’entrée non valide. |
|
L’opération a échoué pour des raisons non spécifiées. |
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 structure NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS.
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Pris en charge dans NDIS 6.20 et versions ultérieures. |
| plateforme cible | Bureau |
| d’en-tête | ndis.h (include Ndis.h) |
| IRQL | PASSIVE_LEVEL |