共用方式為


IWDFDriver::RetrieveVersionString 方法 (wudfddi.h)

[警告: UMDF 2 是最新版的 UMDF,並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1,且較新版本的 #D0BEC1BCF900B4CA7BD2D611DD218D1B0 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱使用 UMDF 使用者入門。]

RetrieveVersionString 方法會擷取架構的版本。

語法

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

參數

[out] pVersion

緩衝區的指標,如果提供的緩衝區不是 NULL 且 RetrieveVersionString 成功,則接收代表架構版本的 NULL 終止字串。

[in, out] pdwVersionLength

變數的指標,可接收 pVersion 所指向之版本字串的大小,以字元為單位。 在輸入時,此變數包含 pVersion 緩衝區的大小,以位元組為單位。

如果 pVersion 上的緩衝區為 NULL,則驅動程式提供的值為零。 架構接著會傳回版本字串所需的大小,以字元為單位。

如果 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 (包括 Wudfddi.h)
Dll WUDFx.dll