Função NdisFSynchronousOidRequest (ndis.h)

Artigo
07/16/2024

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 de 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.

Valor de retorno

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

Observações

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 ser concluídos FilterDetach até que quaisquer solicitações OID síncronas originadas pelo driver de filtro sejam concluídas.

Drivers de filtro não são necessários para implementar FilterOidRequestComplete, FilterDirectOidRequestComplete, FilterSynchronousOidRequestou 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
de cliente com suporte mínimo	Windows 10, versão 1709
da Plataforma de Destino	Universal
cabeçalho	ndis.h (inclua Ndis.h)
biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL

Consulte também

FilterSynchronousOidRequest

FilterSynchronousOidRequestComplete

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

Partilhar via