Função NdisFOidRequest (ndis.h)

  • Artigo

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)

Confira também

FilterAttach

FilterOidRequest

FilterOidRequestComplete

NDIS_OID_REQUEST

NdisOidRequest