Żądania OID CoNDIS MCM

Podobnie jak w przypadku innych menedżerów połączeń CoNDIS, menedżerowie połączeń miniportu (MCM) mogą wysyłać zapytania lub ustawiać parametry operacyjne sterowników klienta CoNDIS. Sterowniki klienta coNDIS mogą wysyłać zapytania lub ustawiać parametry menedżera wywołań lub parametry sterownika miniportu mcM.

Aby zainicjować żądanie OID do sterownika klienta CoNDIS, MCM wywołuje funkcję NdisMCmOidRequest .

Na poniższej ilustracji przedstawiono żądanie identyfikatora OID utworzone przez program MCM.

Gdy sterownik MCM wywołuje funkcję NdisMCmOidRequest, funkcja NDIS wywołuje funkcję ProtocolCoOidRequest sterownika klienta.

Aby zakończyć synchronicznie, NdisMCmOidRequest zwraca NDIS_STATUS_SUCCESS lub stan błędu. Aby ukończyć asynchronicznie, funkcja NdisMCmOidRequest zwraca NDIS_STATUS_PENDING.

Jeśli NdisMCmOidRequest zwraca NDIS_STATUS_PENDING, NDIS wywołuje funkcję ProtocolCoOidRequestComplete MCM po tym, jak sterowniki klienckie zakończą żądanie OID poprzez wywołanie funkcji NdisCoOidRequestComplete. W takim przypadku usługa NDIS przekazuje wyniki żądania w parametrze OidRequestprotokołu ProtocolCoOidRequestComplete. Usługa NDIS przekazuje końcowy stan żądania w parametrze Status funkcji ProtocolCoOidRequestComplete.

Jeśli NdisMCmOidRequest zwraca NDIS_STATUS_SUCCESS, zwraca wyniki żądania w strukturze NDIS_OID_REQUEST w parametrze OidRequest. W takim przypadku NDIS nie wywołuje funkcji ProtocolCoOidRequestComplete MCM.

Sterowniki klienta CoNDIS mogą wysyłać zapytania lub ustawiać parametry operacyjne menedżera wywołań lub parametry operacyjne miniportu mcMs. Aby zainicjować żądanie OID dla parametrów MCM Call Managera, klient wywołuje funkcję NdisCoOidRequest i podaje prawidłowy uchwyt rodziny adresów (AF) w parametrze NdisAfHandle. Aby zainicjować żądanie OID dla parametrów miniportu MCM, klient wywołuje funkcję NdisCoOidRequest i ustawia uchwyt AF na NULL.

Po wywołaniu przez klienta funkcji NdisCoOidRequest usługa NDIS wywołuje funkcję MiniportCoOidRequest lub funkcję ProtocolCoOidRequest sterownika MCM.

Na poniższej ilustracji przedstawiono żądanie identyfikatora obiektu (OID) dla parametrów miniportu MCM.

Na poniższej ilustracji przedstawiono żądanie identyfikatora OID dla parametrów MCM menedżera wywołań.

Aby zakończyć synchronicznie zadanie, NdisCoOidRequest zwraca NDIS_STATUS_SUCCESS lub stan błędu. Aby ukończyć asynchronicznie, ProtocolCoOidRequest lub MiniportCoOidRequest zwraca NDIS_STATUS_PENDING.

Jeśli ProtocolCoOidRequest lub MiniportCoOidRequest zwraca wartość NDIS_STATUS_PENDING, NDIS wywołuje funkcję ProtocolCoOidRequestComplete klienta po zakończeniu żądania OID przez MCM za pomocą funkcji NdisMCoOidRequestComplete lub NdisMCmOidRequestComplete. W takim przypadku usługa NDIS przekazuje wyniki żądania w parametrze OidRequestprotokołu ProtocolCoOidRequestComplete. Usługa NDIS przekazuje końcowy stan żądania w parametrze Status funkcji ProtocolCoOidRequestComplete.

Jeśli NdisCoOidRequest zwraca NDIS_STATUS_SUCCESS, zwraca wyniki zapytania w strukturze NDIS_OID_REQUEST w parametrze OidRequest. W takim przypadku usługa NDIS nie wywołuje funkcji ProtocolCoOidRequestComplete klienta.