FILTER_DEVICE_PNP_EVENT_NOTIFY funzione di callback (ndis.h)

Articolo
02/29/2024

NDIS chiama la funzione FilterDevicePnPEventNotify di un driver di filtro per notificare il driver di eventi di Plug and Play del dispositivo (PnP) e Power Management.

Nota È necessario dichiarare la funzione usando il tipo di FILTER_DEVICE_PNP_EVENT_NOTIFY . Per altre informazioni, vedere la sezione Esempi seguenti.

Sintassi

FILTER_DEVICE_PNP_EVENT_NOTIFY FilterDevicePnpEventNotify;

void FilterDevicePnpEventNotify(
  [in] NDIS_HANDLE FilterModuleContext,
  [in] PNET_DEVICE_PNP_EVENT NetDevicePnPEvent
)
{...}

Parametri

[in] FilterModuleContext

Handle per l'area di contesto per il modulo di filtro. Il driver di filtro creato e inizializzato questa area di contesto nella funzione FilterAttach .

[in] NetDevicePnPEvent

Puntatore a una struttura NET_DEVICE_PNP_EVENT che descrive un evento di Plug and Play dispositivo.

Valore restituito

nessuno

Osservazioni

FilterDevicePnPEventNotify è una funzione facoltativa. Se un driver di filtro non usa richieste PnP del dispositivo, può impostare il punto di ingresso per questa funzione su NULL quando chiama Funzione NdisFRegisterFilterDriver .

FilterDevicePnPEventNotify è simile a quello di un driver miniport Funzione MiniportDevicePnPEventNotify . I driver di filtro possono inoltrare queste notifiche ai driver sottostanti. Per inoltrare una richiesta, chiamare Funzione NdisFDevicePnPEventNotify .

NDIS chiama FilterDevicePnPEventNotify in IRQL = PASSIVE_LEVEL.

Esempi

Per definire una funzione FilterDevicePnPEventNotify , è prima necessario fornire una dichiarazione di funzione che identifica il tipo di funzione che si sta definendo. Windows fornisce un set di tipi di funzione per i driver. La dichiarazione di una funzione usando i tipi di funzione consente l'analisi del codice per i driver, il verifica driver statico (SDV) e altri strumenti di verifica trovano errori ed è un requisito per la scrittura di driver per il sistema operativo Windows.

Ad esempio, per definire una funzione FilterDevicePnPEventNotify denominata "MyDevicePnPEventNotify", usare il tipo di FILTER_DEVICE_PNP_EVENT_NOTIFY come illustrato in questo esempio di codice:

FILTER_DEVICE_PNP_EVENT_NOTIFY MyDevicePnPEventNotify;

Implementare quindi la funzione come indicato di seguito:

_Use_decl_annotations_
VOID
 MyDevicePnPEventNotify(
    NDIS_HANDLE  FilterModuleContext,
    PNET_DEVICE_PNP_EVENT  NetDevicePnPEvent
    )
  {...}

Il tipo di funzione FILTER_DEVICE_PNP_EVENT_NOTIFY è definito nel file di intestazione Ndis.h. Per identificare in modo più accurato gli errori durante l'esecuzione degli strumenti di analisi del codice, assicurarsi di aggiungere l'annotazione Use_decl_annotations alla definizione della funzione. L'annotazione Use_decl_annotations garantisce che vengano usate le annotazioni applicate al tipo di funzione FILTER_DEVICE_PNP_EVENT_NOTIFY nel file di intestazione. Per altre informazioni sui requisiti per le dichiarazioni di funzione, vedere Dichiarazione di funzioni tramite tipi di ruolo per i driver NDIS.

Per informazioni su Use_decl_annotations, vedere Annotazione del comportamento della funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione	Windows
Intestazione	ndis.h (includere Ndis.h)
IRQL	PASSIVE_LEVEL