MINIPORT_PROCESS_SG_LIST función de devolución de llamada (ndis.h)

Un controlador de minipuerto de bus-master proporciona una función MiniportProcessSGList para procesar listas de dispersión y recopilación de datos de red.

Nota Debe declarar la función mediante el tipo MINIPORT_PROCESS_SG_LIST . Para obtener más información, consulte la sección Ejemplos siguientes.

 

Sintaxis

MINIPORT_PROCESS_SG_LIST MiniportProcessSgList;

void MiniportProcessSgList(
  [in] PDEVICE_OBJECT pDO,
  [in] PVOID Reserved,
  [in] PSCATTER_GATHER_LIST pSGL,
  [in] PVOID Context
)
{...}

Parámetros

[in] pDO

Los controladores de minipuerto deben omitir este parámetro.

[in] Reserved

Los controladores de minipuerto deben omitir este parámetro.

[in] pSGL

Puntero a un búfer de lista de dispersión y recopilación. Esto no es necesariamente el mismo búfer que el controlador especificado en la llamada a . Función NdisMAllocateNetBufferSGList

[in] Context

Puntero a un área de contexto que creó el controlador de miniporte antes de llamar a NdisMAllocateNetBufferSGList.

Valor devuelto

None

Observaciones

Los controladores de minipuerto llaman a Función NdisMRegisterScatterGatherDma para registrar una función MiniportProcessSGList . Cuando un controlador de minipuerto llama a NdisMAllocateNetBufferSGList para crear una lista de dispersión y recopilación, NDIS llama a HAL para crear la lista.

NDIS llama a la función MiniportProcessSGList del controlador de miniport si NdisMAllocateNetBufferSGList se realiza correctamente. Sin embargo, una devolución correcta de esa función no garantiza que ya se haya invocado la devolución de llamada; se puede invocar de forma asincrónica.

Cuando NDIS llama a MiniportProcessSGList, el controlador puede enviar la estructura NET_BUFFER al hardware. MiniportProcessSGList envía las direcciones físicas de la lista de dispersión y recopilación al DMA de la NIC y emite un comando de envío a la NIC.

HAL puede llamar a MiniportProcessSGList antes o después de que NDIS devuelva de NdisMAllocateNetBufferSGList. Por lo tanto, los escritores de controladores no deben suponer que la llamada se realiza en el contexto de NdisMAllocateNetBufferSGList.

NDIS llama a MiniportProcessSGList en IRQL = DISPATCH_LEVEL.

Ejemplos

Para definir una función MiniportProcessSGList , primero debe proporcionar una declaración de función que identifique el tipo de función que está definiendo. Windows proporciona un conjunto de tipos de función para controladores. Declarar una función mediante los tipos de función ayuda a Code Analysis for Drivers, Static Driver Verifier (SDV) y otras herramientas de comprobación a encontrar errores y es un requisito para escribir controladores para el sistema operativo Windows.

Por ejemplo, para definir una función MiniportProcessSGList denominada "MyProcessSGList", use el tipo MINIPORT_PROCESS_SG_LIST como se muestra en este ejemplo de código:

MINIPORT_PROCESS_SG_LIST MyProcessSGList;

A continuación, implemente la función de la siguiente manera:

_Use_decl_annotations_
VOID
 MyProcessSGList(
    PDEVICE_OBJECT  pDO,
    PVOID  Reserved,
    PSCATTER_GATHER_LIST  pSGL,
    PVOID  Context
    )
  {...}

El tipo de función MINIPORT_PROCESS_SG_LIST se define en el archivo de encabezado Ndis.h. Para identificar con más precisión los errores al ejecutar las herramientas de análisis de código, asegúrese de agregar la anotación Use_decl_annotations a la definición de función. La anotación Use_decl_annotations garantiza que se usen las anotaciones que se aplican al tipo de función MINIPORT_PROCESS_SG_LIST en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, consulte Declaración de funciones mediante el uso de tipos de roles de función para controladores NDIS.

Para obtener información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Se admite en NDIS 6.0 y versiones posteriores.
Plataforma de destino	Windows
Encabezado	ndis.h (incluya Ndis.h)
IRQL	DISPATCH_LEVEL

Consulte también

NdisMAllocateNetBufferSGList

NdisMRegisterScatterGatherDma