Método IWDFUsbTargetDevice::RetrieveDeviceInformation (wudfusb.h)

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con 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 con 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
S_OK

RetrieveDeviceInformation recuperó correctamente la información del dispositivo.
E_OUTOFMEMORY

RetrieveDeviceInformation encontró un error de asignación.
Código de error definido en Winerror.h
 Este valor corresponde al código de error que devolvió la API winUsb.

Comentarios

Para obtener información sobre los tipos de información válidos que un controlador UMDF puede pasar para el parámetro InformationType , vea la función WinUsb_QueryDeviceInformation .

Si InformationType es DEVICE_SPEED (0x01), al devolverse 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 Value
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1.5
Encabezado wudfusb.h (incluya Wudfusb.h)
Archivo DLL WUDFx.dll

Consulte también

IWDFUsbTargetDevice

WinUsb_QueryDeviceInformation