Функция NdisCoOidRequestComplete (ndis.h)

Статья
02/26/2024

Функция NdisCoOidRequestComplete возвращает окончательное состояние запроса OID, который функция ProtocolCoOidRequest клиента CoNDIS или автономного диспетчера вызовов ранее возвращала NDIS_STATUS_PENDING.

Синтаксис

void NdisCoOidRequestComplete(
  [in]           NDIS_HANDLE       NdisAfHandle,
  [in, optional] NDIS_HANDLE       NdisVcHandle,
  [in, optional] NDIS_HANDLE       NdisPartyHandle,
  [in]           PNDIS_OID_REQUEST OidRequest,
  [in]           NDIS_STATUS       Status
);

Параметры

[in] NdisAfHandle

Дескриптор семейства адресов (AF), который NDIS передается клиенту или автономному диспетчеру вызовов. Функция ProtocolCoOidRequest .

[in, optional] NdisVcHandle

Дескриптор виртуального подключения (VC), который NDIS передается клиенту или функции ProtocolCoOidRequest диспетчера вызовов. Значение NULL для этого параметра указывает, что запрос не зависит от VC. Этот параметр имеет значение NULL , если вызывающий объект функции NdisCoOidRequest или NdisMCmOidRequest указал дескриптор VC NULL .

[in, optional] NdisPartyHandle

Сторонняя дескриптор, переданная NDIS клиенту или функции ProtocolCoOidRequest диспетчера вызовов. Значение NULL для этого параметра указывает, что запрос не зависит от сторон. Этот параметр имеет значение NULL , если вызывающий объект функции NdisCoOidRequest или NdisMCmOidRequest указал дескриптор стороны NULL .

[in] OidRequest

Указатель на буфер, отформатированный как структура NDIS_OID_REQUEST . Вызывающий объект функции NdisCoOidRequest или NdisMCmOidRequest предоставил этот буфер.

[in] Status

Конечное состояние операции запроса, NDIS_STATUS_SUCCESS или любое определенное драйвером значение состояния NDIS_STATUS_XXX, за исключением NDIS_STATUS_PENDING.

Возвращаемое значение

None

Remarks

Драйвер протокола CoNDIS, возвращающий NDIS_STATUS_PENDING из функции ProtocolCoOidRequest , должен вызывать NdisCoOidRequestComplete после того, как драйвер протокола завершит операцию запроса.

После того как драйвер вызывает NdisCoOidRequestComplete, NDIS вызывает Функция ProtocolCoOidRequestComplete драйвера, который изначально вызывал функцию NdisCoOidRequest или NdisMCmOidRequest .

Вызывать NdisCoOidRequestComplete могут только клиенты и автономные диспетчеры вызовов, которые регистрируют себя с помощью NDIS в качестве драйверов протоколов. Диспетчеры вызовов минипорта (MCM) вызывают Функция NdisMCmOidRequestComplete или Вместо этого NdisMCoOidRequestComplete в зависимости от того, обрабатывала ли клиент запрос клиента функция ProtocolCoOidRequest или MiniportCoOidRequest драйвера MCM соответственно.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	Irql_Connection_Function(ndis)