Función WdfDeviceInitSetDeviceType (wdfdevice.h)

[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 de FILE_DEVICE_XXXX que identifica el tipo de dispositivo. Para obtener más información sobre los valores de FILE_DEVICE_XXXX, consulte Especificación de tipos de dispositivo.

Valor devuelto

Ninguno

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 Creating a Framework Device Object.

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 va a escribir 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 cómo usar el Registro, vea Establecer 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	Valor
de la plataforma de destino de	Universal
versión mínima de KMDF	1.0
encabezado de	wdfdevice.h (incluya Wdf.h)
biblioteca de	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)