Compartir a través de


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 NdisFOidRequest en su lugar. NdisFSynchronousOidRequest solo se puede usar para OID compatibles con NDIS para su uso con la interfaz OID sincrónica. La mayoría de los controladores de filtro no necesitan llamar a NdisFSynchronousOidRequest.

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

Consulte también

filterSynchronousOidRequest

FilterSynchronousOidRequestComplete

interfaz de solicitud OID sincrónica en NDIS 6.80