Funzione NdisFOidRequest (ndis.h)

  • Articolo

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

Sintassi

NDIS_STATUS NdisFOidRequest(
  [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, un set o una richiesta di metodo. Per altre informazioni sugli OID, vedere NDIS OID.

Valore restituito

Vedere la funzione NdisOidRequest .

Commenti

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

I driver di filtro possono anche filtrare le richieste OID originate da driver eccessivamente. NDIS chiama la funzione FilterOidRequest per elaborare ogni richiesta.

Se NdisFOidRequest restituisce NDIS_STATUS_PENDING, NDIS chiama la funzione FilterOidRequestComplete dopo che i driver sottostanti completano la richiesta OID.

Se NdisFOidRequest restituisce NDIS_STATUS_SUCCESS, restituisce i risultati di una richiesta di query nella struttura NDIS_OID_REQUEST nel parametro OidRequest .

NdisFOidRequest può restituire NDIS_STATUS_INVALID_PARAMETER se il driver di filtro passa valori non validi per i campi Tipo e Dimensioni nel campo Intestazione della struttura NDIS_OID_REQUEST .

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

Requisiti

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

Vedi anche

FilterAttach

FilterOidRequest

FilterOidRequestComplete

NDIS_OID_REQUEST

NdisOidRequest