Método IWDFDriver::RetrieveVersionString (wudfddi.h)

Artículo
08/08/2023

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método RetrieveVersionString recupera la versión del marco.

Sintaxis

HRESULT RetrieveVersionString(
  [out]     PWSTR pVersion,
  [in, out] DWORD *pdwVersionLength
);

Parámetros

[out] pVersion

Puntero a un búfer que recibe una cadena terminada en NULL que representa la versión del marco si el búfer proporcionado no es NULL y RetrieveVersionString se realiza correctamente.

[in, out] pdwVersionLength

Puntero a una variable que recibe el tamaño, en caracteres, de la cadena de versión a la que apunta pVersion . En la entrada, esta variable contiene el tamaño, en bytes, del búfer en pVersion.

Si el búfer de pVersion es NULL, el valor que proporciona el controlador es cero. A continuación, el marco devuelve el tamaño, en caracteres, que es necesario para la cadena de versión.

Si el búfer de pVersion no es NULL, el marco devuelve el tamaño, en caracteres, de la cadena de versión.

Valor devuelto

RetrieveVersionString devuelve S_OK para los escenarios siguientes:

El búfer al que apunta el parámetro pVersion era distinto de NULL y lo suficientemente grande como para contener la cadena de versión, incluido el carácter NULL . Además, el marco copió correctamente la cadena en el búfer proporcionado y estableció la variable a la que apunta el parámetro pdwVersionLength al número de caracteres de la cadena.
El búfer de pVersion era NULL, el controlador preestablecido la variable en pdwVersionLength en 0 y el marco establece la variable en pdwVersionLength en el número de caracteres necesarios para la cadena.

RetrieveVersionString devuelve HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) para indicar que el búfer proporcionado no es NULL y no contenía suficiente espacio para contener la versión. El marco establece la variable en pdwVersionLength en el número de caracteres necesarios para la cadena.

RetrieveVersionString también podría devolver otros valores HRESULT.

Requisitos

Requisito	Value
Finalización del soporte técnico	No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino	Escritorio
Versión mínima de UMDF	1.5
Encabezado	wudfddi.h (incluya Wudfddi.h)
Archivo DLL	WUDFx.dll