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
S_OK	RetrieveDeviceInformation ha recuperato correttamente le informazioni sul dispositivo.
E_OUTOFMEMORY	RetrieveDeviceInformation ha rilevato un errore di allocazione.
Codice di errore definito in Winerror.h	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

Vedi anche

IWDFUsbTargetDevice

WinUsb_QueryDeviceInformation