Función WdfDeviceInitSetDeviceType (wdfdevice.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfDeviceInitSetDeviceType establece el tipo de dispositivo para un dispositivo especificado.

Sintaxis

void WdfDeviceInitSetDeviceType(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] DEVICE_TYPE     DeviceType
);

Parámetros

[in] DeviceInit

Puntero a una estructura de WDFDEVICE_INIT .

[in] DeviceType

Valor FILE_DEVICE_XXXX que identifica el tipo de dispositivo. Para obtener más información sobre FILE_DEVICE_XXXX valores, vea Especificar tipos de dispositivo.

Valor devuelto

None

Observaciones

Si un controlador llama a WdfDeviceInitSetDeviceType, debe hacerlo antes de llamar a WdfDeviceCreate.

Para obtener más información sobre cómo llamar a WdfDeviceCreate, vea Crear un objeto de dispositivo framework.

El tipo de dispositivo que especifica un controlador determina el valor de aumento de prioridad predeterminado que usa el marco cuando el controlador completa una solicitud de E/S. Para obtener más información sobre los valores de aumento de prioridad, vea Especificar aumentos de prioridad al completar solicitudes de E/S.

Si está escribiendo un controlador UMDF, debe modificar el archivo INF del controlador o realizar cambios en el Registro para especificar un tipo de dispositivo. Para obtener más información sobre el uso del registro, vea Establecer las propiedades del Registro de objetos de dispositivo durante la instalación.

Ejemplos

En el ejemplo de código siguiente se indica que un dispositivo es un dispositivo serie.

WdfDeviceInitSetDeviceType(
                           DeviceInit,
                           FILE_DEVICE_SERIAL_PORT
                           );

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfdevice.h (incluya Wdf.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL <= DISPATCH_LEVEL
Reglas de cumplimiento de DDI ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)