HW_COMPLETE_SERVICE_IRP función de devolución de llamada (storport.h)
Se llama a la rutina HwStorCompleteServiceIrp cuando se quita el adaptador virtual. Cuando esto sucede, la miniport virtual de Storport puede completar cualquier IRP de devolución de llamada inversa recibidas en HwStorCompleteServiceIrp.
Sintaxis
HW_COMPLETE_SERVICE_IRP HwCompleteServiceIrp;
void HwCompleteServiceIrp(
PVOID DeviceExtension
)
{...}
Parámetros
DeviceExtension
Puntero al área de almacenamiento del controlador de minipuerto virtual por adaptador.
Valor devuelto
None
Observaciones
El nombre HwStorCompleteServiceIrp es texto de marcador de posición para el nombre de rutina real. El prototipo real de esta rutina se define en Storport.h de la siguiente manera:
typedef
VOID
HW_COMPLETE_SERVICE_IRP (
_In_ PVOID DeviceExtension
);
El controlador de puerto llama a la rutina HwStorCompleteServiceIrpdel controlador virtual de Storport en PASSIVE_LEVEL sin mantener ningún bloqueo de giro. El controlador de minipuerto virtual completa el IRP llamando a la rutina HwStorCompleteServiceIrp .
Ejemplos
Para definir una función de devolución de llamada HwStorCompleteServiceIrp , primero debe proporcionar una declaración de función que identifique el tipo de función de devolución de llamada que está definiendo. Windows proporciona un conjunto de tipos de función de devolución de llamada para controladores. Declarar una función mediante los tipos de función de devolución de llamada ayuda a Code Analysis for Drivers, Static Driver Verifier (SDV) y otras herramientas de comprobación encuentran errores y es un requisito para escribir controladores para el sistema operativo Windows.
Por ejemplo, para definir una rutina de devolución de llamada HwStorCompleteServiceIrp denominada *&MyHwCompleteServiceIrp, use el tipo de HW_COMPLETE_SERVICE_IRP como se muestra en este ejemplo de código:
HW_COMPLETE_SERVICE_IRP MyHwCompleteServiceIrp;
A continuación, implemente la rutina de devolución de llamada de la siguiente manera:
_Use_decl_annotations_
VOID
MyHwCompleteServiceIrp (
_In_ PVOID DeviceExtension
);
{
...
}
El tipo de función HW_COMPLETE_SERVICE_IRP se define en el archivo de encabezado Storport.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 HW_COMPLETE_SERVICE_IRP 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 tipos de roles de función para controladores storport. Para obtener información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | storport.h (incluya Storport.h) |