Função NdisFOidRequest (ndis.h)
Os drivers de filtro chamam a função NdisFOidRequest para encaminhar uma solicitação OID para drivers subjacentes ou para originar essa solicitação.
Sintaxe
NDIS_STATUS NdisFOidRequest(
[in] NDIS_HANDLE NdisFilterHandle,
[in] PNDIS_OID_REQUEST OidRequest
);
Parâmetros
[in] NdisFilterHandle
Um identificador NDIS que identifica um módulo de filtro. O NDIS passou o identificador para o driver de filtro em uma chamada para a função FilterAttach .
[in] OidRequest
Um ponteiro para uma estrutura NDIS_OID_REQUEST que especifica a operação solicitada com um determinado código OID_XXX . A estrutura pode especificar uma consulta, um conjunto ou uma solicitação de método. Para obter mais informações sobre OIDs, consulte OIDs do NDIS.
Retornar valor
Consulte a função NdisOidRequest .
Comentários
Os drivers de filtro podem originar solicitações OID para drivers subjacentes chamando NdisFOidRequest.
Os drivers de filtro também podem filtrar solicitações OID originadas por drivers sobrepostos. O NDIS chama a função FilterOidRequest para processar cada solicitação.
Se NdisFOidRequest retornar NDIS_STATUS_PENDING, o NDIS chamará a função FilterOidRequestComplete depois que os drivers subjacentes concluirem a solicitação OID.
Se NdisFOidRequest retornar NDIS_STATUS_SUCCESS, ele retornará os resultados de uma solicitação de consulta na estrutura NDIS_OID_REQUEST no parâmetro OidRequest .
NdisFOidRequest poderá retornar NDIS_STATUS_INVALID_PARAMETER se o driver de filtro passar valores inválidos para os campos Tipo e Tamanho no campo Cabeçalho da estrutura NDIS_OID_REQUEST .
Um driver pode chamar NdisFOidRequest quando estiver no estado Reiniciando, Executando, Pausando ou Pausado .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte no NDIS 6.0 e posterior. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | ndis.h (inclua Ndis.h) |
| Biblioteca | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Regras de conformidade da DDI | Irql_OID_Function(ndis) |