IOCTL_NFP_SET_PAYLOAD IOCTL (nfpdev.h)

Eine Clientanwendung sendet Nachrichtendaten und bestätigt die Veröffentlichung mit der IOCTL_NFP_SET_PAYLOAD-Anforderung .

Der Eingabepuffer enthält die zu übertragenden Nachrichtendaten.

Keine.

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

Andernfalls wird Status zur entsprechenden Fehlerbedingung als NTSTATUS-Code verwendet.

Weitere Informationen finden Sie unter NTSTATUS-Werte.

Hinweise

Bei Verwendung dieser IOCTL sind die folgenden Aktionen erforderlich:

Wenn diese IOCTL für ein Handle gesendet wird, das noch nicht für ein "Pubs\..." geöffnet wurde filename, der Treiber MUSS es mit STATUS_INVALID_DEVICE_STATE abschließen.
Die Nachrichtendaten werden einmal geschrieben. Wenn diese IOCTL einmal erfolgreich ist, müssen alle nachfolgenden IOCTL_NFP_SET_PAYLOAD, die auf demselben Handle empfangen werden, mit STATUS_INVALID_DEVICE_STATE abgeschlossen werden.
Wenn die IOCTL einen Ausgabepuffer enthält, MUSS der Treiber die IOCTL mit STATUS_INVALID_PARAMETER abschließen.
Wenn der Eingabepuffer größer als die maximale Nachrichtengröße des Treibers ist, MUSS der Treiber die IOCTL mit STATUS_INVALID_BUFFER_SIZE abschließen.
Wenn ein Gerät nach dem Erfolgreichen dieser IOCTL und vor dem Schließen des Handles in die Nähe wechselt, müssen die Nachrichtendaten (zusammen mit dem Typ) nur einmal an das in der Nähe befindliche Gerät übertragen werden.
Wenn das gleiche (oder andere) Gerät wieder in den Nähe tritt, bevor das Handle geschlossen wird, MUSS die Nachricht erneut übertragen werden.
Wenn sich ein Gerät derzeit in der Nähe befindet, wenn diese IOCTL erfolgreich abgeschlossen wurde, müssen die Nachrichtendaten (zusammen mit dem Typ) (nur einmal) an das in der Nähe befindliche Gerät übertragen werden. Dies gilt auch dann, wenn das Handle sofort geschlossen wird.

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Kopfzeile	nfpdev.h