getcf-Kernel-Service

Zweck

Ruft einen freien Zeichenpuffer ab.

Syntax

#include <sys/types.h>
#include <sys/errno.h>
#include <cblock.h

struct cblock *getcf ( )

Beschreibung

Der GetCF -Kernel-Service ruft einen Zeichenpuffer aus der Liste der verfügbaren Puffer ab und gibt die Adresse dieses Puffers zurück. Der zurückgegebene Zeichenpuffer wird fixiert. Wenn Sie den GetCF -Service verwenden, um einen Zeichenpuffer zu erhalten, stellen Sie sicher, dass Sie den Speicherplatz freigeben, wenn Sie ihn nicht mehr benötigen. Die vom GetCF -Service empfangenen Puffer sollten mithilfe des Putcf -Kernel-Service freigegeben werden.

Bevor der GetCF -Service gestartet wird, sollte der Aufrufende über den Pincf -Kernel-Service genügend Klist -Ressourcen anfordern. Die ordnungsgemäße Verwendung des GetCF -Service stellt sicher, dass dem Aufrufenden genügend fixierte Puffer zur Verfügung stehen.

Wenn der GetCF -Service angibt, dass kein Zeichenpuffer verfügbar ist, kann der Wartestatusfrei -Service aufgerufen werden, um zu warten, bis ein Zeichenpuffer verfügbar ist.

Der GetCF -Service hat keine Parameter.

Ausführungsumgebung

Der GetCF -Kernel-Service kann über die Prozess -oder Unterbrechung -Umgebung aufgerufen werden.

Rückgabewerte

Nach erfolgreicher Beendigung gibt der Service GetCF die Adresse des zugeordneten Zeichenpuffers zurück.

Ein Nullzeiger gibt an, dass keine Puffer verfügbar sind.