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 info, vedi Introduzione con 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 una stringa con terminazione NULL che rappresenta la versione del framework se il buffer fornito è diverso da 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 punta pVersion . In input, questa variabile contiene le dimensioni, in byte, del buffer in pVersion.

Se il buffer in 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 pVersion è diverso da 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 è diverso da NULL e ha dimensioni sufficienti per contenere la stringa di versione, incluso il carattere NULL . Inoltre, il framework ha copiato correttamente la stringa nel buffer fornito e impostare la variabile a cui punta il parametro pdwVersionLength sul numero di caratteri nella stringa.
  • Il buffer in pVersion è 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.

Requisiti

Requisito Valore
Fine del supporto Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione Desktop
Versione UMDF minima 1.5
Intestazione wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll