Funzione NdisFDirectOidRequest (ndis.h)

Articolo
02/26/2024

I driver di filtro chiamano la funzione NdisFDirectOidRequest per inoltrare una richiesta OID diretta ai driver sottostanti o per originare tale richiesta.

Sintassi

NDIS_STATUS NdisFDirectOidRequest(
  [in] NDIS_HANDLE       NdisFilterHandle,
  [in] PNDIS_OID_REQUEST OidRequest
);

Parametri

[in] NdisFilterHandle

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

Per un elenco dei possibili valori restituiti, vedere la funzione NdisDirectOidRequest .

Commenti

La funzione NdisFDirectOidRequest non può essere usata per le richieste OID generali. Per le richieste OID generali, usare invece la funzione NdisFOidRequest . NdisFDirectOidRequest può essere usato solo per gli IDE supportati da NDIS per l'uso con l'interfaccia OID diretta. Ad esempio, è possibile usare gli URI seguenti:

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA

I driver di filtro possono originare richieste OID dirette ai driver sottostanti chiamando NdisFDirectOidRequest.

I driver di filtro possono anche filtrare le richieste OID dirette che vengono originati tramite driver overlying. NDIS chiama la funzione FilterDirectOidRequest per elaborare ogni richiesta.

Se NdisFDirectOidRequest restituisce NDIS_STATUS_PENDING, NDIS chiama la funzione FilterDirectOidRequestComplete dopo che i driver sottostanti completano la richiesta OID. Un driver che chiama NdisFDirectOidRequest deve registrare la funzione FilterDirectOidRequestComplete .

Un driver può chiamare NdisFDirectOidRequest quando si trova nello stato Restarting, Running, Pausing o Paused .

L'interfaccia di richiesta OID diretta è simile all'interfaccia di richiesta OID generale. Per altre informazioni sull'emissione di richieste generali, vedere NdisFOidRequest.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.1 e versioni successive.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (include Ndis.h)
Libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL