IF_QUERY_OBJECT funzione di callback (ndis.h)
La funzione ProviderQueryObject recupera informazioni su un'interfaccia di rete.
Sintassi
IF_QUERY_OBJECT IfQueryObject;
NDIS_STATUS() IfQueryObject(
[in] NDIS_HANDLE ProviderIfContext,
[in] NET_IF_OBJECT_ID ObjectId,
[in, out] PULONG pOutputBufferLength,
[out] PVOID pOutputBuffer
)
{...}
Parametri
[in] ProviderIfContext
Handle che identifica l'area di contesto del provider di interfaccia per l'interfaccia. Il provider di interfaccia ha passato questo handle a NDIS in una chiamata al Funzione NdisIfRegisterInterface .
[in] ObjectId
Identificatore dell'oggetto di destinazione della richiesta di query. Per un elenco di identificatori di oggetto (OID) che si applicano ai provider di interfacce, vedere NDIS Network Interface OIDs.
[in, out] pOutputBufferLength
Puntatore a una variabile fornita da NDIS in cui NDIS fornisce la lunghezza del buffer di output. ProviderQueryObject scrive la lunghezza dei dati inseriti nel buffer di output.
[out] pOutputBuffer
Puntatore a un buffer di output fornito da NDIS in cui ProviderQueryObject scrive la risposta alla richiesta di query.
Valore restituito
ProviderQueryObject restituisce uno dei valori di stato seguenti:
Codice restituito | Descrizione |
---|---|
|
Operazione riuscita. |
|
L'operazione non è riuscita a causa di risorse insufficienti. |
|
La chiamata non è riuscita perché alcuni dei parametri di input non sono validi. |
|
La chiamata non è riuscita per un altro motivo. Questa funzione può propagare codici di errore dalle funzioni chiamate o generare un codice di errore appropriato. |
Commenti
NDIS chiama la funzione ProviderQueryObject del provider di interfaccia di rete per ottenere informazioni su un'interfaccia registrata dal provider. Per un elenco di OID che si applicano ai provider di interfacce, vedere NDIS Network Interface OIDs.
NDIS chiama ProviderQueryObject in IRQL = PASSIVE_LEVEL.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Supportato in NDIS 6.0 e versioni successive. |
Piattaforma di destinazione | Windows |
Intestazione | ndis.h (includere Ndis.h) |
IRQL | PASSIVE_LEVEL |