Função NdisFSynchronousOidRequest (ndis.h)

  • Artigo

Os drivers de filtro chamam a função NdisFSynchronousOidRequest para originar uma nova solicitação OID síncrona e emiti-la para drivers subjacentes.

Essa função tem suporte no NDIS 6.81 e posterior.

Sintaxe

NDIS_STATUS NdisFSynchronousOidRequest(
  [in] NDIS_HANDLE      NdisFilterModuleHandle,
  [in] NDIS_OID_REQUEST *OidRequest
);

Parâmetros

[in] NdisFilterModuleHandle

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

Essa função retorna os mesmos valores que NdisDirectOidRequest, exceto que NDIS_STATUS_PENDING nunca é retornado dessa função.

Comentários

A função NdisFSynchronousOidRequest não pode ser usada para solicitações OID gerais. Para solicitações OID gerais, use a função NdisFOidRequest . NdisFSynchronousOidRequest só pode ser usado para OIDs compatíveis com o NDIS para uso com a interface OID síncrona. A maioria dos drivers de filtro não precisa chamar NdisFSynchronousOidRequest.

Os drivers de filtro não devem concluir FilterDetach até que todas as solicitações OID síncronas originadas pelo driver de filtro sejam concluídas.

Os drivers de filtro não são necessários para implementar FilterOidRequestComplete, FilterDirectOidRequestComplete, FilterSynchronousOidRequest ou FilterSynchronousOidRequestComplete para chamar NdisFSynchronousOidRequest. Como o nome sugere, uma solicitação OID síncrona sempre é concluída de forma síncrona, portanto, não há retorno de chamada assíncrono.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1709
Plataforma de Destino Universal
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL <= DISPATCH_LEVEL

Confira também

FilterSynchronousOidRequest

FilterSynchronousOidRequestComplete

Interface de solicitação OID síncrona no NDIS 6.80