WdfDriverRetrieveVersionString-Funktion (wdfdriver.h)

Artikel
03/22/2025

[Gilt für KMDF und UMDF]

Die WdfDriverRetrieveVersionString--Methode ruft eine Unicode-Zeichenfolge ab, die die Version des Kernel-Mode Driver Framework identifiziert, mit dem der Treiber ausgeführt wird.

Syntax

NTSTATUS WdfDriverRetrieveVersionString(
  [in] WDFDRIVER Driver,
  [in] WDFSTRING String
);

Die Parameter

[in] Driver

Ein Handle für das Framework-Treiberobjekt des Treibers, das der Treiber aus einem vorherigen Aufruf von WdfDriverCreate oder WdfGetDriverabgerufen hat.

[in] String

Ein Handle zu einem Framework-Zeichenfolgenobjekt, das der Treiber aus einem vorherigen Aufruf von WdfStringCreateabgerufen hat. Das Framework weist die Versionszeichenfolge dem Zeichenfolgenobjekt zu.

Rückgabewert

WdfDriverRetrieveVersionString gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode möglicherweise einen der folgenden Werte zurück:

Rückgabecode	BESCHREIBUNG
STATUS_INSUFFICIENT_RESOURCES	Das Framework konnte keinen Puffer für die Unicode-Zeichenfolge zuordnen.

Diese Methode kann auch andere NTSTATUS-Wertezurückgeben.

Eine Systemfehlerüberprüfung tritt auf, wenn das Treiber- Handle ungültig ist.

Bemerkungen

Ihr Treiber kann WdfDriverRetrieveVersionString- aufrufen, wenn Sie eine Zeichenfolge anzeigen möchten, die die Version der Frameworkbibliothek identifiziert. Das Format der Zeichenfolge kann sich von einer Version in eine andere ändern, sodass der Treiber nicht versuchen darf, das Format oder den Inhalt der Zeichenfolge zu interpretieren.

Weitere Informationen zu Bibliotheksversionen finden Sie unter Framework Library Versionsverwaltung.

Beispiele

Im folgenden Codebeispiel wird ein Zeichenfolgenobjekt erstellt, dem Objekt die Versionszeichenfolge zugewiesen und die Zeichenfolge angezeigt, wenn ein Debugger ausgeführt wird.

WDFSTRING string;
UNICODE_STRING us;

status = WdfStringCreate(
                         NULL,
                         WDF_NO_OBJECT_ATTRIBUTES,
                         &string
                         );
if (NT_SUCCESS(status)) {
    status = WdfDriverRetrieveVersionString(
                                            driver,
                                            string
                                            );
    if (NT_SUCCESS(status)) {
        WdfStringGetUnicodeString(
                                  string,
                                  &us
                                  );
        DbgPrint(
                 "WDF Version string:  %wZ\n",
                 &us
                 );
    }
    WdfObjectDelete(string);
}

Anforderungen

Anforderung	Wert
Zielplattform	universell
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Kopfzeile	wdfdriver.h (einschließen Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)