IF_SET_OBJECT funzione di callback (ndis.h)

  • Articolo

La funzione ProviderSetObject imposta informazioni associate a un'interfaccia di rete.

Sintassi

IF_SET_OBJECT IfSetObject;

NDIS_STATUS() IfSetObject(
  [in] NDIS_HANDLE ProviderIfContext,
  [in] NET_IF_OBJECT_ID ObjectId,
  [in] ULONG InputBufferLength,
  [in] PVOID pInputBuffer
)
{...}

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 impostata. Per un elenco di identificatori di oggetto (OID) che si applicano ai provider di interfacce, vedere NDIS Network Interface OIDs.

[in] InputBufferLength

Lunghezza, in byte, del buffer a cui pInputBuffer punta.

[in] pInputBuffer

Puntatore a un buffer di input che specifica le informazioni che il provider di interfacce deve usare per impostare i dati dell'oggetto.

Valore restituito

ProviderSetObject 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 ProviderSetObject del provider di interfaccia di rete per impostare informazioni associate a un'interfaccia registrata dal provider. Per un elenco di OID che si applicano ai provider di interfacce, vedere NDIS Network Interface OIDs.

Si noti che attualmente non sono stati definiti OID impostati.

NDIS chiama ProviderSetObject 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