Función IoUnregisterPlugPlayNotification (wdm.h)
Esta rutina está obsoleta en Windows 7 y versiones posteriores de Windows. Para obtener más información, vea la sección Comentarios a continuación.
La rutina IoUnregisterPlugPlayNotification quita el registro de la rutina de devolución de llamada de un controlador para un evento PnP.
Sintaxis
NTSTATUS IoUnregisterPlugPlayNotification(
[in] PVOID NotificationEntry
);
Parámetros
[in] NotificationEntry
Puntero a un valor opaco que representa el registro que se va a quitar. El valor lo devolvió una llamada anterior a IoRegisterPlugPlayNotification.
Valor devuelto
IoUnregisterPlugPlayNotification siempre devuelve STATUS_SUCCESS si NotificationEntry es válido.
Comentarios
En Windows 7 y versiones posteriores de Windows, esta función está obsoleta y solo se proporciona para admitir controladores existentes. En su lugar, use la rutina IoUnregisterPlugPlayNotificationEx .
El sistema no se sincroniza entre la ejecución de la rutina de notificación y IoUnregisterPlugPlayNotification. Por lo tanto, se puede llamar a la rutina después de que se haya devuelto el método IoUnregisterPlugPlayNotification . Si es necesario, un controlador debe implementar su propio mecanismo para omitir las notificaciones después de llamar a IoUnregisterPlugPlayNotification .
IoUnregisterPlugPlayNotification quita un registro de notificación PnP; es decir, el registro de una rutina de devolución de llamada de controlador para una categoría de eventos PnP.
Los controladores deben anular primero el registro de una notificación y, a continuación, liberar cualquier búfer de contexto relacionado.
Un controlador no se puede descargar hasta que quite todos sus registros de notificación PnP porque hay una referencia en su objeto de controlador para cada registro activo.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |