Partitionsspeicher:Dienstprogramme und Datenstrukturen

Parameter:

Pool – Zeiger auf den Partitionspool, über den Informationen angefordert werden

Name – Zeiger auf einen 8-stelligen Zielbereich für den Namen des Partitionspools; dies beinhaltet Platz für den Null-Terminator.

start_address – ein Zeiger auf eine Variable, die einen Zeiger auf den Anfang des Partitionspool-Datenbereichs erhält

pool_size – ein Zeiger auf eine Variable, die die Größe des Partitionspools (in Bytes) erhält

partition_size – ein Zeiger auf eine Variable, die die Größe der Partitionen in diesem Pool erhält

verfügbar – ein Zeiger auf eine Variable, die die Anzahl der derzeit in diesem Pool verfügbaren Partitionen erhält

zugewiesen – ein Zeiger auf eine Variable, die die Anzahl der derzeit verwendeten Partitionen in diesem Pool erhält

suspend_type – Zeiger auf eine Variable zum Halten des Task-Suspend-Typs; gültige Aufgaben-Aussetzungstypen sind NU_FIFO und NU_PRIORITY .

tasks_waiting – ein Zeiger auf eine Variable, die die Anzahl der in diesem Partitionspool ausgesetzten Tasks empfängt

first_task – ein Zeiger auf einen Taskzeiger, in den der Zeiger der ersten ausgesetzten Task eingefügt wird

Rückgabe:

NU_SUCCESS – der Anruf wurde erfolgreich abgeschlossen

NU_INVALID_POOL – der Partitionspoolzeiger ist nicht gültig

Nucleus SE API-Aufruf für Partitionspool-Informationen

Dieser API-Aufruf unterstützt die Schlüsselfunktionalität der Nucleus RTOS API.

Prototyp für Serviceruf:

STATUS NUSE_Partition_Pool_Information(NUSE_PARTITION_POOL pool, ADDR *start_address, U32 *pool_size, U16 *partition_size, U8 *verfügbar, U8 *zugewiesen, U8 *tasks_waiting, NUSE_TASK *first_task)

Parameter:

Pool – der Index des Partitionspools, über den Informationen angefordert werden

start_address – ein Zeiger auf eine Variable, die einen Zeiger auf den Anfang des Partitionspool-Datenbereichs erhält

pool_size – ein Zeiger auf eine Variable, die die Größe des Partitionspools (in Bytes) erhält

partition_size – ein Zeiger auf eine Variable, die die Größe der Partitionen in diesem Pool erhält

verfügbar – ein Zeiger auf eine Variable, die die Anzahl der derzeit in diesem Pool verfügbaren Partitionen erhält

zugewiesen – ein Zeiger auf eine Variable, die die Anzahl der derzeit verwendeten Partitionen in diesem Pool erhält

tasks_waiting – ein Zeiger auf eine Variable, die die Anzahl der in diesem Partitionspool ausgesetzten Aufgaben empfängt (keine Rückgabe, wenn die Aufgabenaussetzung deaktiviert ist)

first_task – ein Zeiger auf eine Variable vom Typ NUSE_TASK die den Index der ersten ausgesetzten Aufgabe erhält (keine Rückgabe, wenn die Aufgabenaussetzung deaktiviert ist)

Rückgabe:

NUSE_SUCCESS – der Anruf wurde erfolgreich abgeschlossen

NUSE_INVALID_POOL – der Partitionspoolindex ist nicht gültig

NUSE_INVALID_POINTER – einer oder mehrere der Zeigerparameter sind ungültig

Nucleus SE-Implementierung von Partitionspool-Informationen

Die Implementierung dieses API-Aufrufs ist recht einfach:

Die Funktion gibt den Partitionspoolstatus zurück. Wenn das Blockieren von API-Aufrufen aktiviert ist, werden dann die Anzahl der wartenden Tasks und der Index des ersten Tasks zurückgegeben (sonst werden diese beiden Parameter auf 0 gesetzt).

Ermitteln der Anzahl der Partitionspools

Dieser Serviceaufruf gibt die Anzahl der in der Anwendung konfigurierten Partitionspools zurück. Während dies in Nucleus RTOS im Laufe der Zeit schwankt und der zurückgegebene Wert die aktuelle Anzahl von Pools darstellt, wird der zurückgegebene Wert in Nucleus SE zur Build-Zeit festgelegt und kann sich nicht ändern.

Nucleus RTOS API-Aufruf für die Anzahl der Partitionspools

Dieser API-Aufruf unterstützt die Schlüsselfunktionalität der Nucleus RTOS API.

Prototyp für Serviceruf:

UNSIGNED NU_Established_Partition_Pools(VOID);

Parameter:

Keine

Rückgabe:

Die Anzahl der erstellten Partitionspools in der Anwendung

Nucleus SE API-Aufruf für die Anzahl der Partitionspools

Dieser API-Aufruf unterstützt die Schlüsselfunktionalität der Nucleus RTOS API.

Prototyp für Serviceruf:

U8 NUSE_Partition_Pool_Count(void);

Parameter:

Keine

Rückgabe:

Die Anzahl der konfigurierten Partitionspools in der Anwendung

Implementierung

Die Implementierung dieses API-Aufrufs ist fast trivial einfach:Der Wert des #define Symbol NUSE_PARTITION_POOL_NUMBER wird zurückgegeben.