Metodo IWDFDeviceInitialize::RetrieveDeviceInstanceId (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 informazioni, vedi Introduzione a UMDF.]

Il metodo RetrieveDeviceInstanceId recupera l'identificatore di un'istanza di un dispositivo.

Sintassi

HRESULT RetrieveDeviceInstanceId(
  [out, optional] PWSTR Buffer,
  [in, out]       DWORD *pdwSizeInChars
);

Parametri

[out, optional] Buffer

Puntatore a un buffer che riceve un NULLstringa con terminazione che rappresenta l'identificatore di un'istanza di un dispositivo se il buffer fornito non è NULL e RetrieveDeviceInstanceId ha esito positivo.

[in, out] pdwSizeInChars

Puntatore a una variabile che riceve il numero di caratteri, incluso il carattere NULL, nella stringa a cui buffer punta.

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

Se buffer non ènull, il framework restituisce le dimensioni, in caratteri, della stringa dell'identificatore.

Valore restituito

RetrieveDeviceInstanceId restituisce S_OK per gli scenari seguenti:

• Il buffer a cui punta il parametro buffer non era NULL e sufficientemente grande da contenere la stringa dell'identificatore, incluso il carattere NULL e il framework ha copiato correttamente la stringa nel buffer fornito e impostare la variabile a cui punta il parametro pdwSizeInChars al numero di caratteri nella stringa.
• Il buffer in corrispondenza buffer è stato NULL, il driver imposta la variabile in pdwSizeInChars su 0 e il framework imposta la variabile in pdwSizeInChars sul numero di caratteri necessari per la stringa.

RetrieveDeviceInstanceId potrebbe restituire anche altri valori HRESULT.

Fabbisogno

Vedere anche

IWDFDeviceInitialize