Funzione CreateMemoryResourceNotification (memoryapi.h)
Crea un oggetto notifica della risorsa di memoria.
Sintassi
HANDLE CreateMemoryResourceNotification(
[in] MEMORY_RESOURCE_NOTIFICATION_TYPE NotificationType
);
Parametri
[in] NotificationType
Condizione di memoria in cui deve essere segnalato l'oggetto. Questo parametro può essere uno dei valori seguenti dell'enumerazione MEMORY_RESOURCE_NOTIFICATION_TYPE .
| Valore | Significato |
|---|---|
|
La memoria fisica disponibile è insufficiente. |
|
La memoria fisica disponibile è elevata. |
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle per un oggetto notifica della risorsa di memoria.
Se la funzione ha esito negativo, il valore restituito è NULL. Per ottenere informazioni estese, chiamare GetLastError.
Commenti
Le applicazioni possono usare eventi di notifica delle risorse di memoria per ridimensionare l'utilizzo della memoria in base alle esigenze. Se la memoria disponibile è insufficiente, l'applicazione può ridurre il working set. Se la memoria disponibile è elevata, l'applicazione può allocare più memoria.
Qualsiasi thread del processo chiamante può specificare l'handle di notifica delle risorse di memoria in una chiamata alla funzione QueryMemoryResourceNotification o a una delle funzioni di attesa. Lo stato dell'oggetto viene segnalato quando esiste la condizione di memoria specificata. Si tratta di un evento a livello di sistema, quindi tutte le applicazioni ricevono una notifica quando l'oggetto viene segnalato. Si noti che esiste un intervallo di disponibilità di memoria in cui non viene segnalato alcun oggetto LowMemoryResourceNotification o HighMemoryResourceNotification . In questo caso, le applicazioni devono tentare di mantenere costante l'utilizzo della memoria.
Usare la funzione CloseHandle per chiudere l'handle. Il sistema chiude automaticamente l'handle al termine del processo. L'oggetto notifica della risorsa di memoria viene eliminato definitivamente quando l'ultimo handle è stato chiuso.
Per compilare un'applicazione che usa questa funzione, definire la macro _WIN32_WINNT come 0x0501 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | memoryapi.h (include Windows.h, Memoryapi.h) |
| Libreria | onecore.lib |
| DLL | Kernel32.dll |