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