funzione MINIPORT_SYNCHRONOUS_OID_REQUEST (ndis.h)

Articolo
02/26/2024

NDIS chiama la funzione di callback MiniportSynchronousOidRequest di un driver miniport per emettere una richiesta OID sincrona.

Sintassi

NDIS_STATUS MINIPORT_SYNCHRONOUS_OID_REQUEST(
  [in] NDIS_HANDLE      MiniportAdapterContext,
  [in] NDIS_OID_REQUEST *OidRequest
);

Parametri

[in] MiniportAdapterContext

Handle in un'area di contesto allocata dal driver miniport nella funzione MiniportInitializeEx . Il driver miniport usa questa area di contesto per mantenere le informazioni sullo stato per un adattatore miniport.

[in] OidRequest

Puntatore a una struttura NDIS_OID_REQUEST che contiene sia il buffer che il pacchetto di richiesta per il driver miniport da gestire. A seconda della richiesta, il driver restituisce informazioni richieste nella struttura fornita.

Valore restituito

MiniportSynchronousOidRequest può restituire uno dei valori di stato seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	Set di driver miniport o ottenuto i dati come richiesto.
NDIS_STATUS_INVALID_OID	Richiesta specificata da OidRequest non valida o non riconosciuta.
NDIS_STATUS_NOT_SUPPORTED	La richiesta specificata da OidRequest è stata riconosciuta, ma il driver miniport non lo supporta.
NDIS_STATUS_BUFFER_TOO_SHORT	Il buffer fornito da OidRequest era troppo piccolo per contenere i dati richiesti.
NDIS_STATUS_INVALID_LENGTH	Il valore specificato nel membro InformationBufferLength della struttura NDIS_OID_REQUEST in OidRequest non è corretto per il codice OID_Xxx specificato.
NDIS_STATUS_INVALID_DATA	Uno o più parametri specificati per la richiesta in OidRequest non sono validi.
NDIS_STATUS_INDICATION_REQUIRED	Il driver miniport fornirà uno stato di completamento OID con un'indicazione di stato successiva. Un driver miniport non può restituire NDIS_STATUS_INDICATION_REQUIRED a meno che l'OID specifico non lo consenta. Per determinare se questo stato è consentito, vedere la pagina di riferimento dell'OID. Per altre informazioni sulle NDIS_STATUS_INDICATION_REQUIRED, vedere NDIS_OID_REQUEST e NDIS_STATUS_INDICATION.
NDIS_STATUS_NOT_ACCEPTED	Dopo aver chiamato il Funzione MiniportDevicePnPEventNotify per indicare una rimozione delle sorprese, NDIS denominata funzione MiniportHaltEx del driver. Se il driver ha ricevuto richieste OID prima di NDIS chiama MiniportHaltEx, deve completare immediatamente tali richieste con un valore di stato di NDIS_STATUS_NOT_ACCEPTED. I driver miniport non sono sempre necessari per restituire NDIS_STATUS_NOT_ACCEPTED per tutti gli ID dopo una rimozione a sorpresa, ma in questo modo aiuta a spiegare perché la chiamata non è riuscita.

Commenti

MiniportSynchronousOidRequest è una funzione facoltativa. Un driver miniport registra questa funzione se gestisce le richieste OID sincrone. Il driver specifica il punto di ingresso MiniportSynchronousOidRequest quando chiama la funzione NdisMRegisterMiniportDriver usando il membro SynchronousOidRequestHandler della struttura NDIS_MINIPORT_DRIVER_CHARACTERISTICS .

I driver Miniport non devono restituire NDIS_STATUS_PENDING o NDIS_STATUS_REQUEST_ABORTED da MiniportSynchronousOidRequest. Le richieste OID sincrone non possono essere pennate o annullate.

I driver miniport possono restituire NDIS_STATUS_NOT_ACCEPTED dopo che NDIS chiama MiniportDevicePnPEventNotify per notificare al driver la rimozione della sorpresa del dispositivo. Tuttavia, i driver miniport possono comunque completare la richiesta OID con un codice di stato diverso, se è possibile farlo. Per altre informazioni, vedere la documentazione specifica di ogni OID.

I driver miniport devono completare rapidamente le richieste OID sincrone senza bloccare, attendere o dormire. Le richieste OID sincrone vengono usate solo per operazioni a bassa latenza e i driver miniport devono cercare di completarli entro diversi millisecondi. La maggior parte delle richieste OID viene recapitata a MiniportOidRequest, che è consentita per pennare o attendere durate più lunghe.

NDIS non serializza le richieste OID sincrone tra loro, rispetto ad altre richieste OID, contro MiniportPause, contro MiniportResetEx o contro le transizioni di alimentazione. È responsabilità del driver miniport implementare la propria sincronizzazione e di non riuscire le richieste recapitate alla volta in cui la richiesta non può essere gestita correttamente.

NDIS serializza le richieste OID sincrone rispetto a MiniportHaltEx; NDIS garantisce che nessuna richiesta OID sincrona sarà attiva una volta richiamata MiniportHaltEx .

I driver Miniport che implementano la sospensione selettiva NDIS non sono compatibili con gli ID sincroni e non devono registrare un gestore MiniportSynchronousOidRequest .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1709
Piattaforma di destinazione	Windows
Intestazione	ndis.h (includere Ndis.h)
IRQL	<= DISPATCH_LEVEL