Funzione WdfDriverRetrieveVersionString (wdfdriver.h)

Articolo
03/22/2025

[Si applica a KMDF e UMDF]

Il metodo WdfDriverRetrieveVersionString recupera una stringa Unicode che identifica la versione di Kernel-Mode Driver Framework con cui è in esecuzione il driver.

Sintassi

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

Parametri

[in] Driver

Handle per l'oggetto driver del framework del driver ottenuto dal driver da una chiamata precedente a WdfDriverCreare o WdfGetDriver.

[in] String

Handle per un oggetto stringa del framework ottenuto dal driver da una chiamata precedente a WdfStringCreate. Il framework assegna la stringa di versione all'oggetto stringa.

Valore restituito

WdfDriverRetrieveVersionString restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_INSUFFICIENT_RESOURCES	Il framework non è riuscito ad allocare un buffer per la stringa Unicode.

Questo metodo può anche restituire altri valori NTSTATUS .

Se l'handle driver di non è valido, si verifica un controllo dei bug di sistema.

Osservazioni:

Il driver può chiamare WdfDriverRetrieveVersionString se si vuole visualizzare una stringa che identifica la versione della libreria framework. Il formato della stringa potrebbe cambiare da una versione a un'altra, quindi il driver non deve tentare di interpretare il formato o il contenuto della stringa.

Per altre informazioni sulle versioni della libreria, vedere Framework Library Versioning.

Esempi

Nell'esempio di codice seguente viene creato un oggetto stringa, viene assegnata la stringa di versione all'oggetto e viene visualizzata la stringa se è in esecuzione un debugger.

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);
}

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfdriver.h (include Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

WdfDriverCreare

WdfDriverIsVersionAvailable

WdfGetDriver

WdfObjectDelete

WdfStringCreare

WdfStringGetUnicodeString

Condividi tramite