Metodo IWDFUsbTargetDevice::RetrieveDeviceInformation (wudfusb.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 RetrieveDeviceInformation recupera le informazioni sul dispositivo del tipo specificato.
Sintassi
HRESULT RetrieveDeviceInformation(
[in] ULONG InformationType,
[in, out] ULONG *BufferLength,
[out] PVOID Buffer
);
Parametri
[in] InformationType
Tipo di informazioni richieste dal driver UMDF sul dispositivo.
[in, out] BufferLength
Puntatore a una variabile che, all'input, contiene le dimensioni, in byte, del buffer fornito da RetrieveDeviceInformation in Buffer. Nell'output, questo parametro contiene le dimensioni richieste da RetrieveDeviceInformation per Buffer.
[out] Buffer
Puntatore che riceve il buffer che contiene le informazioni sul dispositivo.
Valore restituito
RetrieveDeviceInformation restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
RetrieveDeviceInformation ha recuperato correttamente le informazioni sul dispositivo. |
|
RetrieveDeviceInformation ha rilevato un errore di allocazione. |
|
Questo valore corrisponde al codice di errore restituito dall'API WinUsb. |
Commenti
Per informazioni sui tipi di informazioni validi che un driver UMDF può passare per il parametro InformationType , vedere la funzione WinUsb_QueryDeviceInformation .
Se InformationType è DEVICE_SPEED (0x01), in caso di esito positivo, Buffer indica la velocità operativa del dispositivo. 0x03 indica velocità elevata o superiore; 0x01 indica la velocità massima o inferiore.
Il metodo RetrieveDeviceInformation genera una richiesta UMDF e invia in modo sincrono la richiesta alla destinazione di I/O.
Esempio
Per un esempio di codice su come usare il metodoRetrieveDeviceInformation , vedi IWDFUsbTargetPipe::SetPipePolicy.
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 | wudfusb.h (include Wudfusb.h) |
| DLL | WUDFx.dll |