IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

Artikel
08/07/2023

Ein Client sendet die IOCTL_NFP_DISABLE Anforderung zum vorübergehenden Deaktivieren von Abonnements, Veröffentlichungen und Anwesenheitsereignissen. Dies ist nützlich, wenn ein Client die Näherungsfunktion deaktivieren möchte, aber die zugewiesenen Ressourcen beibehalten möchte, um sie bei Bedarf schnell wieder zu aktivieren.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Keine

Ausgabepuffer

Keine

Statusblock

Irp-IoStatus.Status> ist auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist.

Andernfalls wird status für die entsprechende Fehlerbedingung als NTSTATUS-Code verwendet.

Weitere Informationen finden Sie unter NTSTATUS-Werte.

Hinweise

Die folgenden Aktionen sind erforderlich, wenn Sie dieses IOCTL verwenden:

Wenn diese IOCTL empfangen wird, muss der Treiber das Dateihandle als "Deaktiviert" markieren.
Wenn ein Abonnementhandle in "Deaktiviert" geändert wird, muss der Anbieter alle Nachrichten aus der Warteschlange "Empfangen" dieses Dateihandles entfernen.
Wenn ein Abonnementhandle "Deaktiviert" ist:
- Der Treiber MUSS die "Empfangene" Warteschlange dieses Handles auf null Länge halten, indem vorhandene Nachrichten in der Warteschlange gelöscht (gelöscht) und neue Nachrichten aus der Warteschlange gelöscht werden, sobald sie empfangen werden.
- Der Treiber MUSS alle IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE Anforderungen für dieses Handle mit STATUS_CANCELLED abschließen.
Wenn ein Veröffentlichungshandle "Deaktiviert" ist, DARF der Anbieter die Nachricht der Veröffentlichung NICHT übertragen, und er MUSS alle geschriebenen IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE Anforderungen für dieses Handle mit STATUS_CANCELLED