Żądania OID sterownika Miniport CoNDIS

Usługa NDIS wywołuje funkcję MiniportCoOidRequestw miniportowym sterowniku CoNDIS, aby przesłać żądanie OID w celu zapytania lub ustawienia informacji w sterowniku. Usługa NDIS wywołuje MiniportCoOidRequest we własnym imieniu lub w imieniu nadrzędnego sterownika, który wywołał funkcję NdisCoOidRequest.

Usługa NDIS przekazuje MiniportCoOidRequest wskaźnik do struktury NDIS_OID_REQUEST, która zawiera informacje o żądaniu. Struktura żądań zawiera identyfikator OID_Xxx wskazujący typ żądania oraz inne elementy definiujące dla danych żądania.

Członek Timeout określa limit czasu, w sekundach, dla żądania. Usługa NDIS może zresetować sterownik lub anulować żądanie, jeśli limit czasu wygaśnie przed ukończeniem żądania przez sterownik.

Członek RequestId określa opcjonalny identyfikator żądania. Sterowniki miniportu mogą ustawić członek stanu wskazania RequestId na wartość uzyskaną z członka RequestId w skojarzonym żądaniu OID. Zazwyczaj sterowniki miniportów mogą ignorować ten składnik. Jeśli sterownik musi ustawić ten człon, powinien użyć jednej z wymaganych wartości, określonych na stronie z odniesieniem dla danego identyfikatora OID. Aby uzyskać więcej informacji o sygnalizacjach stanu, zobacz CoNDIS Miniport Driver Status Indications.

Sterownik miniportu może wykonać żądanie OID synchronicznie, zwracając stan powodzenia lub niepowodzenia. Sterownik może wykonać żądanie OID asynchronicznie, zwracając NDIS_STATUS_PENDING. W takim przypadku sterownik musi wywołać funkcję NdisMCoOidRequestComplete, aby ukończyć operację.

Jeśli funkcja MiniportCoOidRequest zwraca NDIS_STATUS_PENDING, NDIS może wywołać MiniportCoOidRequest z innym żądaniem dotyczącym karty przed ukończeniem oczekującego żądania. Należy pamiętać, że różni się to od interfejsu NDIS bez połączenia, w którym wszystkie żądania OID są serializowane.

Usługa NDIS może wywołać funkcję MiniportCancelOidRequest sterownika miniportu w celu anulowania żądania OID CoNDIS.