CreateMemoryResourceNotification 函式 (memoryapi.h)

建立記憶體資源通知物件。

語法

HANDLE CreateMemoryResourceNotification(
  [in] MEMORY_RESOURCE_NOTIFICATION_TYPE NotificationType
);

參數

[in] NotificationType

要發出訊號物件的記憶體條件。 此參數可以是下列 MEMORY_RESOURCE_NOTIFICATION_TYPE列舉值 之一。

傳回值

如果函式成功，則傳回值是記憶體資源通知物件的控制碼。

如果函式失敗，傳回值為 Null。 若要取得擴充資訊，請呼叫 GetLastError。

備註

應用程式可以使用記憶體資源通知事件，適當地調整記憶體使用量。 如果可用的記憶體不足，應用程式可以減少其工作集。 如果可用的記憶體很高，應用程式可以配置更多記憶體。

呼叫進程的任何執行緒都可以在 QueryMemoryResourceNotification 函式或其中一個 等候函式的呼叫中指定記憶體資源通知控制碼。 當指定的記憶體條件存在時，物件的狀態會發出訊號。 這是全系統的事件，因此所有應用程式都會在收到物件的訊號時收到通知。 請注意，記憶體可用性範圍不會發出 LowMemoryResourceNotification 或 HighMemoryResourceNotification 物件的訊號。 在此情況下，應用程式應該嘗試保留記憶體使用常數。

使用 CloseHandle 函式關閉控制碼。 當進程終止時，系統會自動關閉控制碼。 當最後一個控制碼關閉時，就會終結記憶體資源通知物件。

若要編譯使用此函式的應用程式，請將_WIN32_WINNT巨集定義為 0x0501 或更新版本。 如需詳細資訊，請參閱 使用 Windows 標頭。

需求

另請參閱

CloseHandle

記憶體管理功能

QueryMemoryResourceNotification