Funzione NdisFSynchronousOidRequest (ndis.h)

Articolo
07/16/2024

I driver di filtro chiamano la funzione NdisFSynchronousOidRequest per avere origine una nuova richiesta OID sincrona e rilasciarla ai driver sottostanti.

Questa funzione è supportata in NDIS 6.81 e versioni successive.

Sintassi

NDIS_STATUS NdisFSynchronousOidRequest(
  [in] NDIS_HANDLE      NdisFilterModuleHandle,
  [in] NDIS_OID_REQUEST *OidRequest
);

Parametri

[in] NdisFilterModuleHandle

Handle NDIS che identifica un modulo di filtro. NDIS ha passato l'handle al driver di filtro in una chiamata alla funzione filterAttach FilterAttach.

[in] OidRequest

Puntatore a una struttura NDIS_OID_REQUEST che specifica l'operazione richiesta con un determinato codice OID_Xxx. La struttura può specificare una query, un set o una richiesta di metodo OID.

Valore restituito

Questa funzione restituisce gli stessi valori di NdisDirectOidRequesttranne che NDIS_STATUS_PENDING non viene mai restituito da questa funzione.

Osservazioni

La funzione NdisFSynchronousOidRequest non può essere usata per le richieste OID generali. Per le richieste OID generali, usare invece la funzione NdisFOidRequest. NdisFSynchronousOidRequest può essere usato solo per gli IDE supportati da NDIS per l'uso con l'interfaccia OID sincrona. La maggior parte dei driver di filtro non deve chiamare NdisFSynchronousOidRequest.

I driver di filtro non devono completare FilterDetach finché non vengono completate le richieste OID sincrone originate dal driver di filtro.

I driver di filtro non sono necessari per implementare FilterOidRequestComplete, FilterDirectOidRequestComplete, FilterSynchronousOidRequesto FilterSynchronousOidRequestComplete per chiamare NdisFSynchronousOidRequest. Come suggerisce il nome, una richiesta OID sincrona viene sempre completata in modo sincrono, quindi non esiste alcun callback asincrono.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1709
piattaforma di destinazione	Universale
intestazione	ndis.h (include Ndis.h)
libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL

Vedere anche

FilterSynchronousOidRequest

FilterSynchronousOidRequestComplete

interfaccia di richiesta OID sincrona in NDIS 6.80

Condividi tramite