Funzione NdisFDirectOidRequest (ndis.h)

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:

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

Vedi anche

FilterAttach

FilterDirectOidRequest

NDIS_OID_REQUEST

NdisDirectOidRequest

NdisFOidRequest