Condividi tramite

Richieste OID del driver miniport CoNDIS

  • Articolo

NDIS chiama una funzione Miniport MiniportCoOidRequest di CoNDIS per inviare una richiesta OID per eseguire query o impostare informazioni nel driver. NDIS chiama MiniportCoOidRequest per proprio conto o per conto di un driver overlying che ha chiamato la funzione NdisCoOidRequest .

NDIS passa MiniportCoOidRequest a un puntatore a una struttura NDIS_OID_REQUEST contenente le informazioni sulla richiesta. La struttura della richiesta contiene un identificatore OID_Xxx che indica il tipo di richiesta e altri membri per definire i dati della richiesta.

Il membro Timeout specifica un timeout , in secondi, per la richiesta. NDIS può reimpostare il driver o annullare la richiesta se il timeout scade prima che il driver completi la richiesta.

Il membro RequestId specifica un identificatore facoltativo per la richiesta. I driver Miniport possono impostare il membro RequestId di un'indicazione di stato sul valore ottenuto dal membro RequestId di una richiesta OID associata. In genere, i driver miniport possono ignorare questo membro. Se un driver deve impostare questo membro, il driver deve usare uno dei valori necessari, specificati nella pagina di riferimento per l'OID specifico. Per altre informazioni sulle indicazioni sullo stato, vedere Indicazioni sullo stato del driver Miniport CoNDIS.

Un driver miniport può completare una richiesta OID in modo sincrono restituendo uno stato di esito positivo o negativo. Il driver può completare una richiesta OID in modo asincrono restituendo NDIS_STATUS_PENDING. In questo caso, il driver deve chiamare la funzione NdisMCooidRequestComplete per completare l'operazione.

Se la funzione MiniportCoOidRequest restituisce NDIS_STATUS_PENDING, NDIS può chiamare MiniportCoOidRequest con un'altra richiesta per l'adattatore prima del completamento della richiesta in sospeso. Si noti che questa operazione è diversa dall'interfaccia NDIS senza connessione in cui vengono serializzate tutte le richieste OID.

NDIS può chiamare la funzione MiniportCancelOidRequest di un driver miniport per annullare una richiesta OID CoNDIS.