Método IWDFUsbTargetDevice::RetrieveDeviceInformation (wudfusb.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción a UMDF.]
El método RetrieveDeviceInformation recupera la información del dispositivo del tipo especificado.
Sintaxis
HRESULT RetrieveDeviceInformation(
[in] ULONG InformationType,
[in, out] ULONG *BufferLength,
[out] PVOID Buffer
);
Parámetros
[in] InformationType
Tipo de información que solicita el controlador UMDF sobre el dispositivo.
[in, out] BufferLength
Puntero a una variable que, en la entrada, contiene el tamaño, en bytes, del búfer que RetrieveDeviceInformation proporciona en Buffer. En la salida, este parámetro contiene el tamaño que retrieveDeviceInformation requiere para buffer.
[out] Buffer
Puntero que recibe el búfer que contiene la información del dispositivo.
Valor devuelto
RetrieveDeviceInformation devuelve uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
|
RetrieveDeviceInformation recuperó correctamente la información del dispositivo. |
|
RetrieveDeviceInformation encontró un error de asignación. |
|
Este valor corresponde al código de error que devolvió la API de WinUsb. |
Observaciones
Para obtener información sobre los tipos de información válidos que un controlador UMDF puede pasar para el parámetro InformationType, consulte la función WinUsb_QueryDeviceInformation.
Si InformationType es DEVICE_SPEED (0x01), si se devuelve correctamente, buffer indica la velocidad de funcionamiento del dispositivo. 0x03 indica alta velocidad o superior; 0x01 indica velocidad completa o inferior.
El método RetrieveDeviceInformation genera una solicitud UMDF y envía sincrónicamente la solicitud al destino de E/S.
Ejemplos
Para obtener un ejemplo de código de cómo usar el métodoRetrieveDeviceInformation, vea IWDFUsbTargetPipe::SetPipePolicy.
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.5 |
| encabezado de | wudfusb.h (incluya Wudfusb.h) |
| DLL de | WUDFx.dll |