Función WdfDriverRetrieveVersionString (wdfdriver.h)
[Se aplica a KMDF y UMDF]
El método WdfDriverRetrieveVersionString recupera una cadena Unicode que identifica la versión de Kernel-Mode Driver Framework con la que se ejecuta el controlador.
Sintaxis
NTSTATUS WdfDriverRetrieveVersionString(
[in] WDFDRIVER Driver,
[in] WDFSTRING String
);
Parámetros
[in] Driver
Identificador del objeto de controlador del marco de trabajo del controlador que obtuvo el controlador de una llamada anterior a WdfDriverCreate o WdfGetDriver.
[in] String
Identificador de un objeto de cadena de marco que el controlador obtuvo de una llamada anterior a WdfStringCreate. El marco asigna la cadena de versión al objeto string.
Valor devuelto
WdfDriverRetrieveVersionString devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método podría devolver uno de los siguientes valores:
| Código de retorno | Descripción |
|---|---|
|
El marco no pudo asignar un búfer para la cadena Unicode. |
Este método también puede devolver otros valores de NTSTATUS.
Se produce una comprobación de errores del sistema si el controlador de no es válido.
Observaciones
El controlador puede llamar a WdfDriverRetrieveVersionString si desea mostrar una cadena que identifique la versión de la biblioteca de marcos. El formato de la cadena puede cambiar de una versión a otra, por lo que el controlador no debe intentar interpretar el formato o el contenido de la cadena.
Para obtener más información sobre las versiones de biblioteca, vea Framework Library Versioning.
Ejemplos
En el ejemplo de código siguiente se crea un objeto de cadena, se asigna la cadena de versión al objeto y se muestra la cadena si se está ejecutando un depurador.
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);
}
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado | wdfdriver.h (incluya Wdf.h) |
| Biblioteca | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |