Función WdfDeviceInitSetCharacteristics (wdfdevice.h)

[Solo se aplica a KMDF]

El método WdfDeviceInitSetCharacteristics establece las características del dispositivo para un dispositivo especificado.

Sintaxis

void WdfDeviceInitSetCharacteristics(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] ULONG           DeviceCharacteristics,
  [in] BOOLEAN         OrInValues
);

Parámetros

[in] DeviceInit

Puntero a una estructura de WDFDEVICE_INIT .

[in] DeviceCharacteristics

Valor que consta de constantes definidas por el sistema ORed que representan características del dispositivo. Para obtener más información, vea el miembro Características de la estructura DEVICE_OBJECT .

[in] OrInValues

Valor booleano. Si este valor es TRUE, el valor DeviceCharacteristics es ORed con características de dispositivo existentes. Si el valor es FALSE, el valor DeviceCharacteristics reemplaza las características de dispositivo existentes.

Valor devuelto

None

Observaciones

Para establecer las características del dispositivo, llame al método WdfDeviceInitSetCharacteristics en la función de devolución de llamada EvtDriverDeviceAdd antes de llamar a WdfDeviceCreate. Si el controlador no puede determinar las características de un dispositivo hasta después de que se devuelva la función de devolución de llamada EvtDriverDeviceAdd , llame a WdfDeviceSetCharacteristics.

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

El marco siempre establece la característica FILE_DEVICE_SECURE_OPEN, por lo que el controlador no tiene que establecer esta característica.

Cada llamada a WdfDeviceInitSetCharacteristics sobrescribe la configuración de cualquier llamada anterior.

Ejemplos

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

WdfDeviceInitSetCharacteristics(
                                DeviceInit,
                                FILE_FLOPPY_DISKETTE,
                                FALSE
                                );

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), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Consulte también

WdfDeviceSetCharacteristics