Požadavky na OID miniportového ovladače CoNDIS

NDIS volá funkci MiniportCoOidRequest ovladače miniportu CoNDIS k odeslání požadavku OID za účelem dotazování nebo nastavení informací v ovladači. NDIS volá MiniportCoOidRequest buď vlastním jménem, nebo jménem nadřízeného ovladače, který zavolal funkci NdisCoOidRequest.

NDIS předá MiniportCoOidRequest ukazatel na NDIS_OID_REQUEST strukturu, která obsahuje informace o požadavku. Struktura požadavku obsahuje identifikátor OID_Xxx, který označuje typ požadavku a další členy definující data žádosti.

Časový limit člen určuje časový limit požadavku v sekundách. NDIS může ovladač resetovat nebo žádost zrušit, pokud vyprší časový limit před dokončením žádosti.

RequestId člen určuje volitelný identifikátor požadavku. Ovladače miniportu mohou nastavit člena indikace stavu RequestId na hodnotu, kterou ovladač získal z člena přidružené žádosti OID RequestId. Ovladače miniportu můžou obvykle tento člen ignorovat. Pokud ovladač musí nastavit tento člen, musí použít jednu z požadovaných hodnot, které jsou zadány na referenční stránce pro konkrétní identifikátor OID. Další informace o indikaci stavu naleznete v tématu CoNDIS Miniport Informace o stavu ovladače.

Ovladač miniportu může požadavek OID synchronně dokončit vrácením stavu úspěchu nebo selhání. Ovladač může požadavek OID dokončit asynchronně vrácením NDIS_STATUS_PENDING. V tomto případě musí ovladač volat funkci NdisMCoOidRequestComplete, aby dokončil operaci.

Pokud funkce MiniportCoOidRequest vrátí NDIS_STATUS_PENDING, může NDIS volat MiniportCoOidRequest s jiným požadavkem na adaptér před dokončením čekajícího požadavku. Měli byste si uvědomit, že se to liší od rozhraní bez připojení NDIS, kde jsou všechny požadavky OID serializovány.

NDIS může volat miniport ovladače MiniportCancelOidRequest funkci pro zrušení požadavku CoNDIS OID.