Поделиться через

Метод IWDFDriver::RetrieveVersionString (wudfddi.h)

  • Статья

[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]

Метод RetrieveVersionString извлекает версию платформы.

Синтаксис

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

Параметры

[out] pVersion

Указатель на буфер, который получает NULL--завершенную строку, представляющую версию платформы, если предоставленный буфер не являетсяNULL и RetrieveVersionString успешно.

[in, out] pdwVersionLength

Указатель на переменную, которая получает размер в символах строки версии, на которую pVersion указывает. В входных данных эта переменная содержит размер буфера в байтах в pVersion.

Если буфер в pVersionNULL, значение, которое предоставляет драйвер, равно нулю. Затем платформа возвращает размер в символах, необходимых для строки версии.

Если буфер в pVersion неNULL, платформа возвращает размер строки версии в символах.

Возвращаемое значение

RetrieveVersionString возвращает S_OK для следующих сценариев:

  • Буфер, на который указывает параметр pVersion, неNULL и достаточно большой для хранения строки версии, включая символ NULL. Кроме того, платформа успешно скопировала строку в предоставленный буфер и задайте переменную, на которую указывает параметр pdwVersionLength число символов в строке.
  • Буфер в pVersion был NULL, драйвер предустановил переменную в pdwVersionLength значение 0, а платформа задает переменную в pdwVersionLength число символов, необходимых для строки.
RetrieveVersionString возвращает HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER), чтобы указать, что предоставленный буфер не являетсяNULL и не содержал достаточно места для хранения версии. Платформа задает переменную в pdwVersionLength число символов, необходимых для строки.

RetrieveVersionString также может возвращать другие значения HRESULT.

Требования

Требование Ценность
завершение поддержки Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа Настольный
минимальная версия UMDF 1.5
заголовка wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll