Función NdisFSynchronousOidRequest (ndis.h)
Los controladores de filtro llaman a la función NdisFSynchronousOidRequest para originar una nueva solicitud de OID sincrónica y emitirla a los controladores subyacentes.
Esta función se admite en NDIS 6.81 y versiones posteriores.
Sintaxis
NDIS_STATUS NdisFSynchronousOidRequest(
[in] NDIS_HANDLE NdisFilterModuleHandle,
[in] NDIS_OID_REQUEST *OidRequest
);
Parámetros
[in] NdisFilterModuleHandle
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 de OID_Xxx determinado. La estructura puede especificar una consulta de OID, un conjunto o una solicitud de método.
Valor devuelto
Esta función devuelve los mismos valores que NdisDirectOidRequest, excepto que nunca se devuelve NDIS_STATUS_PENDING de esta función.
Observaciones
No se puede usar la función NdisFSynchronousOidRequest para las solicitudes OID generales. En el caso de las solicitudes OID generales, use la función
Los controladores de filtro no deben completarse FilterDetach hasta que se completen las solicitudes OID sincrónicas originadas por el controlador de filtro.
No es necesario implementar controladores de filtro FilterOidRequestComplete, FilterDirectOidRequestComplete, FilterSynchronousOidRequesto FilterSynchronousOidRequestComplete para llamar a NdisFSynchronousOidRequest. Como su nombre sugiere, una solicitud de OID sincrónica siempre se completa sincrónicamente, por lo que no hay ninguna devolución de llamada asincrónica.
Requisitos
Requisito | Valor |
---|---|
cliente mínimo admitido | Windows 10, versión 1709 |
de la plataforma de destino de |
Universal |
encabezado de |
ndis.h (incluya Ndis.h) |
biblioteca de |
Ndis.lib |
irQL | <= DISPATCH_LEVEL |