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.
NTSTATUS WdfDeviceAddDependentUsageDeviceObject(
[in] WDFDEVICE Device,
[in] PDEVICE_OBJECT DependentDevice
);
[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.
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 |
---|---|
|
DependentDevice es null. |
|
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.
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.
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
);
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) |