IF_QUERY_OBJECT funzione di callback (ndis.h)

  • Articolo

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
NDIS_STATUS_SUCCESS
 Operazione riuscita.
NDIS_STATUS_RESOURCES
 L'operazione non è riuscita a causa di risorse insufficienti.
NDIS_STATUS_INVALID_PARAMETER
 La chiamata non è riuscita perché alcuni dei parametri di input non sono validi.
NDIS_STATUS_Xxx
 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

Vedi anche

NdisIfRegisterInterface