Funzione NdisFSynchronousOidRequest (ndis.h)

  • Articolo

I driver di filtro chiamano la funzione NdisFSynchronousOidRequest per generare 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 .

[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 OID, un set o una richiesta di metodo.

Valore restituito

Questa funzione restituisce gli stessi valori di NdisDirectOidRequest, ad eccezione del fatto che NDIS_STATUS_PENDING non viene mai restituito da questa funzione.

Commenti

Impossibile usare la funzione NdisFSynchronousOidRequest per le richieste OID generali. Per le richieste OID generali, usare invece la funzione NdisFOidRequest . NdisFSynchronousOidRequest può essere usato solo per gli OID 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, FilterSynchronousOidRequest o FilterSynchronousOidRequestComplete per chiamare NdisFSynchronousOidRequest. Come suggerisce il nome, una richiesta OID sincrona completa sempre in modo sincrono, quindi non esiste un callback asincrono.

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 1709
Piattaforma di destinazione Universale
Intestazione ndis.h (includere Ndis.h)
Libreria Ndis.lib
IRQL <= DISPATCH_LEVEL

Vedi anche

FilterSynchronousOidRequest

FilterSynchronousOidRequestComplete

Interfaccia richiesta OID sincrona in NDIS 6.80