Condividi tramite

Metodo IWDFDriver::RetrieveVersionString (wudfddi.h)

  • Articolo

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]

Il metodo RetrieveVersionString recupera la versione del framework.

Sintassi

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

Parametri

[out] pVersion

Puntatore a un buffer che riceve un NULLstringa con terminazione che rappresenta la versione del framework se il buffer fornito non è NULL e RetrieveVersionString ha esito positivo.

[in, out] pdwVersionLength

Puntatore a una variabile che riceve le dimensioni, in caratteri, della stringa di versione a cui pVersion punta. In caso di input, questa variabile contiene le dimensioni, in byte, del buffer in corrispondenza di pVersion.

Se il buffer in corrispondenza pVersion è NULL, il valore fornito dal driver è zero. Il framework restituisce quindi le dimensioni, in caratteri, necessarie per la stringa di versione.

Se il buffer in corrispondenza pVersion non èNULL, il framework restituisce le dimensioni, in caratteri, della stringa di versione.

Valore restituito

RetrieveVersionString restituisce S_OK per gli scenari seguenti:

  • Il buffer a cui punta il parametro pVersion non era NULL e di dimensioni sufficienti per contenere la stringa di versione, incluso il carattere NULL. Inoltre, il framework ha copiato correttamente la stringa nel buffer fornito e impostato la variabile a cui punta il parametro pdwVersionLength al numero di caratteri nella stringa.
  • Il buffer in pVersion è stato NULL, il driver imposta la variabile in pdwVersionLength su 0 e il framework imposta la variabile in pdwVersionLength sul numero di caratteri necessari per la stringa.
RetrieveVersionString restituisce HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) per indicare che il buffer fornito non è NULL e non contiene spazio sufficiente per contenere la versione. Il framework imposta la variabile in pdwVersionLength sul numero di caratteri necessari per la stringa.

RetrieveVersionString potrebbe restituire anche altri valori HRESULT.

Fabbisogno

Requisito Valore
Fine del supporto Non disponibile in UMDF 2.0 e versioni successive.
piattaforma di destinazione Desktop
versione minima di UMDF 1.5
intestazione wudfddi.h (include Wudfddi.h)
dll WUDFx.dll