Función NdisFDirectOidRequest (ndis.h)

Artículo
02/29/2024

Los controladores de filtro llaman a la función NdisFDirectOidRequest para reenviar una solicitud OID directa a los controladores subyacentes o para originar dicha solicitud.

Sintaxis

NDIS_STATUS NdisFDirectOidRequest(
  [in] NDIS_HANDLE       NdisFilterHandle,
  [in] PNDIS_OID_REQUEST OidRequest
);

Parámetros

[in] NdisFilterHandle

Identificador NDIS que identifica un módulo de filtro. NDIS pasó el identificador al controlador de filtro en una llamada a la función FilterAttach .

[in] OidRequest

Puntero a una estructura NDIS_OID_REQUEST que especifica la operación que se solicita con un código OID_Xxx determinado. La estructura puede especificar una consulta de OID, un conjunto o una solicitud de método.

Valor devuelto

Para obtener una lista de los posibles valores devueltos, consulte la función NdisDirectOidRequest .

Comentarios

La función NdisFDirectOidRequest no se puede usar para las solicitudes OID generales. En el caso de las solicitudes OID generales, use la función NdisFOidRequest en su lugar. NdisFDirectOidRequest solo se puede usar para los NDIS compatibles con NDIS para su uso con la interfaz OID directa. Por ejemplo, se pueden usar los siguientes OID:

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA

Los controladores de filtro pueden originar solicitudes OID directas a los controladores subyacentes llamando a NdisFDirectOidRequest.

Los controladores de filtro también pueden filtrar las solicitudes de OID directas que se originan mediante controladores excesivos. NDIS llama a la función FilterDirectOidRequest para procesar cada solicitud de este tipo.

Si NdisFDirectOidRequest devuelve NDIS_STATUS_PENDING, NDIS llama a la función FilterDirectOidRequestComplete después de que los controladores subyacentes completen la solicitud de OID. Un controlador que llama a NdisFDirectOidRequest debe registrar la función FilterDirectOidRequestComplete .

Un controlador puede llamar a NdisFDirectOidRequest cuando se encuentra en el estado Reinicio, En ejecución, Pausa o Pausado .

La interfaz de solicitud OID directa es similar a la interfaz de solicitud OID general. Para obtener más información sobre cómo emitir solicitudes generales, vea NdisFOidRequest.

Requisitos

Requisito	Value
Cliente mínimo compatible	Se admite en NDIS 6.1 y versiones posteriores.
Plataforma de destino	Escritorio
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL