IF_SET_OBJECT funzione di callback (ndis.h)

Articolo
02/07/2025

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 interfacce per l'interfaccia. Il provider di interfaccia ha passato questo handle a NDIS in una chiamata a funzione NdisIfRegisterInterface.

[in] ObjectId

Identificatore per l'oggetto che rappresenta la destinazione della richiesta set. Per un elenco degli identificatori di oggetto (OID) che si applicano ai provider di interfaccia, vedere NDIS Network Interface OID.

[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 completata correttamente.
NDIS_STATUS_RESOURCES	L'operazione non è riuscita a causa di risorse insufficienti.
NDIS_STATUS_INVALID_PARAMETER	La chiamata non è riuscita perché alcuni parametri di input non sono validi.
NDIS_STATUS_Xxx	La chiamata non è riuscita per un altro motivo. Questa funzione può propagare i codici di errore dalle funzioni chiamate o generare un codice di errore appropriato.

Osservazioni

NDIS chiama la funzione ProviderSetObject di un provider di interfacce di rete per impostare le informazioni associate a un'interfaccia registrata dal provider. Per un elenco di OID applicabili ai provider di interfaccia, vedere NDIS Network Interface OID.

Si noti che attualmente non sono definiti URI impostati.

NDIS chiama ProviderSetObject in IRQL = PASSIVE_LEVEL.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
piattaforma di destinazione	Finestre
intestazione	ndis.h (include Ndis.h)
IRQL	PASSIVE_LEVEL

Vedere anche

NdisIfRegisterInterface

Condividi tramite