Función NdisFOidRequest (ndis.h)

  • Artículo

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

Sintaxis

NDIS_STATUS NdisFOidRequest(
  [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 solicitada con un código OID_XXX determinado. La estructura puede especificar una consulta, un conjunto o una solicitud de método. Para obtener más información sobre los OID, consulte NDIS OID.

Valor devuelto

Consulte la función NdisOidRequest .

Comentarios

Los controladores de filtro pueden originar solicitudes de OID a los controladores subyacentes mediante una llamada a NdisFOidRequest.

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

Si NdisFOidRequest devuelve NDIS_STATUS_PENDING, NDIS llama a la función FilterOidRequestComplete después de que los controladores subyacentes completen la solicitud OID.

Si NdisFOidRequest devuelve NDIS_STATUS_SUCCESS, devuelve los resultados de una solicitud de consulta en la estructura NDIS_OID_REQUEST en el parámetro OidRequest .

NdisFOidRequest puede devolver NDIS_STATUS_INVALID_PARAMETER si el controlador de filtro pasa valores no válidos para los campos Tipo y Tamaño del campo Encabezado de la estructura NDIS_OID_REQUEST .

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

Requisitos

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

Consulte también

FilterAttach

FilterOidRequest

FilterOidRequestComplete

NDIS_OID_REQUEST

NdisOidRequest