Żądania OID sterownika protokołu CoNDIS

Sterowniki protokołu CoNDIS, klienci lub menedżerowie połączeń, mogą wysyłać zapytania lub ustawiać parametry operacyjne sterowników miniportu i innych sterowników protokołów. Sterowniki protokołu CoNDIS mogą również wysyłać zapytania lub ustawiać informacje w menedżerach połączeń miniportu (MCMs). Aby uzyskać więcej informacji na temat żądań OID i MCMs, zobacz CoNDIS MCM OID Requests (Żądania OID CoNDIS MCM).

Aby zainicjować żądanie OID do bazowego sterownika, sterownik protokołu wywołuje funkcję NdisCoOidRequest i ustawia uchwyt rodziny adresów (AF) w parametrze NdisAfHandle na NULL. Aby zainicjować żądanie OID do innego sterownika protokołu CoNDIS, sterownik protokołu wywołuje NdisCoOidRequest i zapewnia prawidłowy uchwyt AF.

Po wywołaniu funkcji NdisCoOidRequest sterownik protokołu NDIS wywołuje funkcję żądania OID innego sterownika (sterownik źródłowy lub inny sterownik protokołu CoNDIS). W przypadku sterowników miniportu NDIS wywołuje funkcję MiniportCoOidRequest . W przypadku sterowników protokołów, NDIS wywołuje funkcję ProtocolCoOidRequest.

Na poniższej ilustracji przedstawiono żądanie identyfikatora OID skierowane do sterownika miniportu.

Na poniższej ilustracji przedstawiono żądanie OID skierowane do sterownika protokołu.

Aby zakończyć synchronicznie zadanie, NdisCoOidRequest zwraca NDIS_STATUS_SUCCESS lub stan błędu. Aby wykonać asynchronicznie, funkcja NdisCoOidRequest zwraca wartość NDIS_STATUS_PENDING.

Jeśli NdisCoOidRequest zwraca NDIS_STATUS_PENDING, funkcja NDIS wywołuje ProtocolCoOidRequestComplete po zakończeniu żądania OID przez wywołanie NdisMCoOidRequestComplete lub 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 element NdisCoOidRequest zwraca NDIS_STATUS_SUCCESS, zwraca wyniki żądania zapytania w strukturze NDIS_OID_REQUEST w punktach parametrów OidRequest . W takim przypadku usługa NDIS nie wywołuje funkcji ProtocolCoOidRequestComplete .

Jeśli podstawowy sterownik powinien skojarzyć żądanie OID z kolejnym wskazaniem stanu, sterownik protokołu powinien ustawić elementy członkowskie RequestId i RequestHandle w strukturze NDIS_OID_REQUEST. Jeśli podstawowy sterownik wskazuje stan, sterownik ustawia element RequestId w strukturze NDIS_STATUS_INDICATION na wartość z elementu RequestId struktury NDIS_OID_REQUEST i element DestinationHandle w strukturze NDIS_STATUS_INDICATION na wartość z elementu RequestHandle struktury NDIS_OID_REQUEST.

Sterownik może wywołać funkcję NdisCoOidRequest, gdy powiązanie jest w stanie Ponowne uruchamianie, Uruchamianie, Wstrzymywanie lub Wstrzymany.