RtlDeleteElementGenericTable-Funktion (ntddk.h)

Die RtlDeleteElementGenericTable-Routine löscht ein Element aus einer generischen Tabelle.

Syntax

NTSYSAPI BOOLEAN RtlDeleteElementGenericTable(
  [in] PRTL_GENERIC_TABLE Table,
  [in] PVOID              Buffer
);

Parameter

[in] Table

Ein Zeiger auf die generische Tabelle (RTL_GENERIC_TABLE). Die Tabelle muss durch Aufrufen von RtlInitializeGenericTable initialisiert worden sein.

[in] Buffer

Ein Zeiger auf einen vom Aufrufer zugeordneten Puffer, der einen Wert enthält, der das zu löschende Element eindeutig identifiziert.

Rückgabewert

RtlDeleteElementGenericTable gibt TRUE zurück, wenn das Element erfolgreich gelöscht wurde, andernfalls FALSE .

Hinweise

RtlDeleteElementGenericTable ruft die CompareRoutine und FreeRoutine auf , die im Aufruf von RtlInitializeGenericTable registriert wurden.

Anrufer der Rtl.. GenericTable-Routinen sind für die ausschließliche Synchronisierung des Zugriffs auf die generische Tabelle verantwortlich. Ein exklusiver schneller Mutex ist der effizienteste Synchronisierungsmechanismus, der für diesen Zweck verwendet werden kann.

Standardmäßig verwendet das Betriebssystem Splay-Strukturen, um generische Tabellen zu implementieren. Unter bestimmten Umständen wird die Struktur durch Vorgänge in einer Splay-Struktur tief und schmal und kann sogar in eine gerade Linie umgewandelt werden. Sehr tiefe Strukturen beeinträchtigen die Leistung von Suchvorgängen. Sie können eine ausgewogenere, flachere Strukturimplementierung generischer Tabellen sicherstellen, indem Sie Adelson-Velsky/Landis-Strukturen (AVL) verwenden. Wenn Sie die generischen Tabellenroutinen so konfigurieren möchten, dass sie AVL-Strukturen anstelle von Splaystrukturen in Ihrem Treiber verwenden, fügen Sie die folgende define-Anweisung in eine allgemeine Headerdatei ein, bevor Sie Ntddk.h einschließen:

#define RTL_USE_AVL_TABLES 0

Wenn RTL_USE_AVL_TABLES nicht definiert ist, müssen Sie die AVL-Form der generischen Tabellenroutinen verwenden. Verwenden Sie beispielsweise die RtlDeleteElementGenericTableAvl-Routine anstelle von RtlDeleteElementGenericTable. Im Aufruf von RtlDeleteElementGenericTableAvl muss der Aufrufer anstelle von RTL_GENERIC_TABLE eine RTL_AVL_TABLE Tabellenstruktur übergeben.

Aufrufer von RtlDeleteElementGenericTable müssen unter IRQL < DISPATCH_LEVEL ausgeführt werden, wenn eine der folgenden Bedingungen erfüllt ist:

• Der vom Aufrufer zugeordnete Arbeitsspeicher bei Table oder buffer kann ausgelagert werden.
• Die vom Aufrufer bereitgestellte CompareRoutine oder FreeRoutine enthält auslagerungsfähigen Code.

Anforderungen

Weitere Informationen

RtlInitializeGenericTable

RtlInsertElementGenericTable