Función NdisFOidRequest (ndis.h)
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) |