Função NdisFDirectOidRequest (ndis.h)
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ódigoxxx OID_. A estrutura pode especificar uma consulta OID, um conjunto ou uma solicitação de método.
Valor de retorno
Para obter uma lista de possíveis valores retornados, consulte a função NdisDirectOidRequest.
Observações
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_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SAOs 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 em excesso. 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 após 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 de Reinicialização do, em Execução, pausarou estado de pausado.
A interface de solicitação OID direta é semelhante à interface de solicitação OID geral. Para obter mais informações sobre a emissão de solicitações gerais, consulte NdisFOidRequest.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte no NDIS 6.1 e posterior. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ndis.h (inclua Ndis.h) |
| biblioteca | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |