Função NdisFDirectOidRequest (ndis.h)

Artigo
03/01/2024

Os drivers de filtro chamam a função NdisFDirectOidRequest para encaminhar uma solicitação OID direta para drivers subjacentes ou para originar essa solicitação.

Sintaxe

NDIS_STATUS NdisFDirectOidRequest(
  [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 OID, um conjunto ou uma solicitação de método.

Retornar valor

Para obter uma lista de possíveis valores retornados, consulte a função NdisDirectOidRequest .

Comentários

A função NdisFDirectOidRequest não pode ser usada para solicitações OID gerais. Para solicitações OID gerais, use a função NdisFOidRequest . NdisFDirectOidRequest só pode ser usado para OIDs compatíveis com o NDIS para uso com a interface OID direta. Por exemplo, os seguintes OIDs podem ser usados:

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA

Os drivers de filtro podem originar solicitações OID diretas para drivers subjacentes chamando NdisFDirectOidRequest.

Os drivers de filtro também podem filtrar solicitações OID diretas originadas por drivers sobrepostos. O NDIS chama a função FilterDirectOidRequest para processar cada solicitação desse tipo.

Se NdisFDirectOidRequest retornar NDIS_STATUS_PENDING, o NDIS chamará a função FilterDirectOidRequestComplete depois que os drivers subjacentes concluirem a solicitação OID. Um driver que chama NdisFDirectOidRequest deve registrar a função FilterDirectOidRequestComplete .

Um driver pode chamar NdisFDirectOidRequest quando estiver no estado Reiniciando, Executando, Pausando ou Pausado .

A interface de solicitação OID direta é semelhante à interface de solicitação OID geral. Para obter mais informações sobre como emitir solicitações gerais, consulte NdisFOidRequest.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no NDIS 6.1 e posterior.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL