Función WdfDeviceAddDependentUsageDeviceObject (wdfdevice.h)

[Solo se aplica a KMDF]

El método WdfDeviceAddDependentUsageDeviceObject indica que un dispositivo especificado depende de otro dispositivo cuando se usa el dispositivo especificado para almacenar archivos especiales.

Sintaxis

NTSTATUS WdfDeviceAddDependentUsageDeviceObject(
  [in] WDFDEVICE      Device,
  [in] PDEVICE_OBJECT DependentDevice
);

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

[in] DependentDevice

Puntero a una estructura de DEVICE_OBJECT proporcionada por el autor de la llamada que identifica un dispositivo del que depende Dispositivo.

Valor devuelto

Si la operación se realiza correctamente, WdfDeviceAddDependentUsageDeviceObject método devuelve STATUS_SUCCESS. Entre los valores devueltos adicionales se incluyen:

Código devuelto Descripción
STATUS_INVALID_PARAMETER
DependentDevice es null.
STATUS_INSUFFICIENT_RESOURCES
Error en la asignación de memoria.
 

El método podría devolver otros valores ntstatus de .

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Observaciones

El controlador puede llamar a WdfDeviceAddDependentUsageDeviceObject para indicar que el dispositivo identificado por Device depende del dispositivo identificado por DependentDevice, cuando Device admite archivos especiales. Si el controlador llama a WdfDeviceAddDependentUsageDeviceObject, el marco llama a las funciones de devolución de llamada EvtDeviceUsageNotification en DependentDevicelos controladores antes de llamar al EvtDeviceUsageNotification funciones de devolución de llamada en Controladores del dispositivo.

El controlador puede llamar a WdfDeviceAddDependentUsageDeviceObject varias veces para identificar varios dispositivos que Dispositivo depende de admitir archivos especiales.

Después de llamar a un controlador WdfDeviceAddDependentUsageDeviceObject, puede llamar a WdfDeviceRemoveDependentUsageDeviceObject para quitar el dispositivo identificado por DependentDevice de la lista de dispositivos de los que depende Dispositivo.

Para obtener más información sobre los archivos especiales, vea compatibilidad con archivos especiales.

Ejemplos

En el ejemplo de código siguiente se agrega un dispositivo (pDeviceObject) a la lista de dispositivos de los que depende otro dispositivo (Device).

status = WdfDeviceAddDependentUsageDeviceObject(
                                                device,
                                                pDeviceObject
                                                );

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

Consulte también

EvtDeviceUsageNotification

WdfDeviceRemoveDependentUsageDeviceObject