IOCTL_NFCRM_SET_RADIO_STATE IOCTL (nfcradiodev.h)

Dieses IOCTL wird von der Funkverwaltungsanwendung oder dem Dienst verwendet, um den Funkleistungszustand des Näherungsgeräts festzulegen. Das MediaRadioOn-Feld wird verwendet, um den Energiestatus der Anforderung anzugeben. Wenn der Näherungsfunkbetrieb deaktiviert ist, sollte der Treiber die Näherungsgeräteschnittstellen (GUID_DEVINTERFACE_NFP- und GUID_DEVINTERFACE_SMARTCARD_READER schnittstellen) deaktivieren und die P2P- und Lese-/Schreibmodus des Geräts deaktivieren. Wenn der Näherungsfunkzustand aktiviert ist, sollte der Treiber die Näherungsgeräteschnittstellen und den P2P- und Lese-/Schreibmodus des Controllers aktivieren. Weitere Informationen zum Optimieren der Energiemodi auf diesem Gerät finden Sie unter NFC Power Management.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

NFCRM_SET_RADIO_STATE Struktur

Eingabepufferlänge

sizeof(NFCRM_SET_RADIO_STATE)

Ausgabepuffer

Keine

Länge des Ausgabepuffers

Keine

Statusblock

Irp->IoStatus.Status ist auf STATUS_SUCCESS festgelegt, wenn die Anforderung erfolgreich ist. Mögliche Fehlercodes sind:

Code zurückgeben	BESCHREIBUNG
STATUS_INVALID_DEVICE_STATE	Dieser Code wird zurückgegeben, wenn sich das Gerät bereits im Näherungsfunkzustand befindet, der vom Client festgelegt wird.

Hinweise

Der STATUS_INVALID_PARAMETER Rückgabecode ist nicht mehr erforderlich. In Windows 10 Build 10240 wurde ein Fehler festgestellt, dass Windows mit dieser IOCTL einen Ausgabeparameter ungleich NULL sendet. Dieser Fehler wurde in späteren Versionen von Windows behoben. Um Code zu vereinfachen, können Treiber die Ausgabeparameter in allen Versionen von Windows 10 ignorieren.

Anforderungen

Anforderung	Wert
Header	nfcradiodev.h