Metodo IWDFDriver::RetrieveVersionString (wudfddi.h)
[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 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 |