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 de NDIS_OID_REQUEST que especifica a operação solicitada com um determinado códigoXXX OID_. 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.
Valor de retorno
Consulte a função NdisOidRequest.
Observações
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 em excesso. 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 de Tipo e tamanho no campo cabeçalho da estrutura NDIS_OID_REQUEST.
Um driver pode chamar NdisFOidRequest quando ele estiver no de Reinicialização, Executando, pausandoou estado de pausado.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte no NDIS 6.0 e posterior. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ndis.h (inclua Ndis.h) |
| biblioteca | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| regras de conformidade de DDI | Irql_OID_Function(ndis) |