Funzione WdfFdoInitSetFilter (wdffdo.h)

Articolo
03/22/2025

[Si applica a KMDF e UMDF]

Il metodo WdfFdoInitSetFilter identifica il driver chiamante come driver di livello superiore o inferiore driver di filtroper un dispositivo specificato.

Sintassi

void WdfFdoInitSetFilter(
  [in] PWDFDEVICE_INIT DeviceInit
);

Parametri

[in] DeviceInit

Puntatore a una struttura di WDFDEVICE_INIT ottenuta dal driver dal relativo EvtDriverDeviceAdd funzione di callback.

Valore restituito

Nessuno

Osservazioni:

I driver di filtro elaborano in genere alcune richieste di I/O, ma passano semplicemente la maggior parte delle richieste al driver successivo nello stack di driver. Se il framework riceve una richiesta per uno dei dispositivi del driver e se il driver non ha creato una coda di I/O per ricevere richieste che corrispondono al tipo di richiesta, il modo in cui il framework elabora la richiesta dipende dal fatto che il driver abbia chiamato WdfFdoInitSetFilter:

Se un driver chiama WdfFdoInitSetFilter, il framework driver inoltra la richiesta al driver successivo.
Se un driver non chiama WdfFdoInitSetFilter, il framework completa la richiesta con un valore di stato STATUS_INVALID_DEVICE_REQUEST.

Se un driver chiama WdfFdoInitSetFilter, non deve chiamare WdfDeviceInitSetIoType, WdfDeviceInitSetPowerInrusho WdfDeviceInitSetPowerPageable perché il framework ignora le informazioni fornite da queste chiamate. Il framework ottiene invece queste informazioni dall'oggetto dispositivo inferiore successivo nello stack di dispositivi driver.

Il driver deve chiamare WdfFdoInitSetFilter prima di chiamare WdfDeviceCreate. Per altre informazioni sulla chiamata di WdfDeviceCreate, vedere Creating a Framework Device Object. Inoltre, il driver deve chiamare WdfFdoInitSetFilter prima di tornare dalla relativa EvtDriverDeviceAdd funzione di callback.

Per altre informazioni su WdfFdoInitSetFilter, vedere Creating Device Objects in a Filter Driver, Creating I/O Queues and Forwarding I/O Requests.

Esempi

L'esempio di codice seguente identifica il driver chiamante come driver di filtro per il dispositivo specificato.

WdfFdoInitSetFilter(DeviceInit);

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdffdo.h (include Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
regole di conformità DDI	DeviceInitAPI(kmdf), DriverCreate(kmdf), DrvAckIoStop(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

WDFDEVICE_INIT

Condividi tramite