Funzione NdisFOidRequest (ndis.h)
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 FilterAttach.
[in] OidRequest
Puntatore a una struttura NDIS_OID_REQUEST che specifica l'operazione richiesta con un determinato OID_codice 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 di NdisOidRequest.
Osservazioni
I driver di filtro possono avere origine richieste OID ai driver sottostanti chiamando NdisFOidRequest.
I driver di filtro possono anche filtrare le richieste OID originate da driver eccessivamente aggiornati. 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 Type e Size nel campo Header della struttura NDIS_OID_REQUEST.
Un driver può chiamare NdisFOidRequest quando si trova nello stato di Restarting, Running, Pausingo Stato sospeso.