ALLOCATE_SHARED_MEMORY_HANDLER Rückruffunktion (ndis.h)
Die NetAllocateSharedMemory-Funktion (ALLOCATE_SHARED_MEMORY_HANDLER Einstiegspunkt) wird von NDIS aufgerufen, wenn ein Treiber freigegebenen Arbeitsspeicher von einem Shared Memory-Anbieter zuordnet.
Syntax
ALLOCATE_SHARED_MEMORY_HANDLER AllocateSharedMemoryHandler;
NDIS_STATUS AllocateSharedMemoryHandler(
[in] NDIS_HANDLE ProviderContext,
[in] PNDIS_SHARED_MEMORY_PARAMETERS SharedMemoryParameters,
[in, out] PNDIS_HANDLE pSharedMemoryProviderContext
)
{...}
Parameter
[in] ProviderContext
Ein NDIS_HANDLE zu einem Block von vom Treiber zugewiesenen Kontextinformationen, die den Anbieter identifiziert. Der Anbieter hat diese Informationen im ProviderContext-Member des NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS Struktur.
[in] SharedMemoryParameters
Ein Zeiger auf eine NDIS_SHARED_MEMORY_PARAMETERS Struktur, die die angeforderten Attribute für den freigegebenen Arbeitsspeicher definiert.
[in, out] pSharedMemoryProviderContext
Ein Zeiger auf ein Handle für einen Shared Memory-Kontextbereich. Der Shared Memory-Anbieter stellt ein Handle bereit, das den freigegebenen Arbeitsspeicher identifiziert, den er zugeordnet hat.
Rückgabewert
NetAllocateSharedMemory kann die folgenden status-Werte zurückgeben:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Der Vorgang ist fehlgeschlagen, weil nicht genügend Ressourcen zum Abschließen des Vorgangs vorhanden waren. |
|
Der Vorgang ist aufgrund eines ungültigen Eingabeparameters fehlgeschlagen. |
|
Der Vorgang ist aus nicht angegebenen Gründen fehlgeschlagen. |
Hinweise
NDIS ruft die NetAllocateSharedMemory-Funktion eines Anbieters für gemeinsam genutzten Speicher auf, wenn ein Treiber die NdisAllocateSharedMemory-Funktion .
Der Shared Memory-Anbieter hat den Einstiegspunkt (ALLOCATE_SHARED_MEMORY_HANDLER) für NetAllocateSharedMemory in der NDIS_SHARED_MEMORY_PROVIDER_CHARACTERISTICS Struktur.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in NDIS 6.20 und höher. |
| Zielplattform | Desktop |
| Kopfzeile | ndis.h (include Ndis.h) |
| IRQL | PASSIVE_LEVEL |