Funzione WdfDeviceAddDependentUsageDeviceObject (wdfdevice.h)

Articolo
02/27/2024

[Si applica solo a KMDF]

Il metodo WdfDeviceAddDependentUsageDeviceObject indica che un dispositivo specificato dipende da un altro dispositivo quando il dispositivo specificato viene usato per archiviare file speciali.

Sintassi

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

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] DependentDevice

Puntatore a una struttura di DEVICE_OBJECT fornita dal chiamante che identifica un dispositivo a seconda del dispositivo.

Valore restituito

Se l'operazione ha esito positivo, il metodo WdfDeviceAddDependentUsageDeviceObject restituisce STATUS_SUCCESS. I valori restituiti aggiuntivi includono:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	DependentDevice è NULL.
STATUS_INSUFFICIENT_RESOURCES	Un'allocazione di memoria non riuscita.

Il metodo potrebbe restituire altri valori NTSTATUS.

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Il driver può chiamare WdfDeviceAddDependentUsageDeviceObject per indicare che il dispositivo identificato dal dispositivo dipende dal dispositivo identificato da DependentDevice, quando Il dispositivo supporta file speciali. Se il driver chiama WdfDeviceAddDependentUsageDeviceObject, il framework chiama le funzioni di callback EvtDeviceUsageNotification nei driver di DependentDevice prima di chiamare le funzioni di callback EvtDeviceUsageNotification nei driver del dispositivo.

Il driver può chiamare WdfDeviceAddDependentUsageDeviceObject più volte per identificare più dispositivi a seconda del dispositivo per supportare file speciali.

Dopo che un driver ha chiamato WdfDeviceAddDependentUsageDeviceObject, può chiamare WdfDeviceRemoveDependentUsageDeviceObject per rimuovere il dispositivo identificato da DependentDevice dall'elenco dei dispositivi a seconda del dispositivo .

Per altre informazioni sui file speciali, vedere Supporto di file speciali.

Esempio

Nell'esempio di codice seguente viene aggiunto un dispositivo (pDeviceObject) all'elenco di dispositivi a cui dipende un altro dispositivo (dispositivo).

status = WdfDeviceAddDependentUsageDeviceObject(
                                                device,
                                                pDeviceObject
                                                );

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Intestazione	wdfdevice.h (includere Wdf.h)
Libreria	Wdf01000.sys (vedere Framework Library Versioning).
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

EvtDeviceUsageNotification

WdfDeviceRemoveDependentUsageDeviceObject