IOCTL_NFP_SET_PAYLOAD IOCTL (nfpdev.h)
クライアント アプリケーションはメッセージ データを送信し、 IOCTL_NFP_SET_PAYLOAD 要求でパブリケーションを確認します。
メジャー コード
[入力バッファー]
入力バッファーには、送信するメッセージ データが含まれています。
出力バッファー
[なし] :
ステータス ブロック
要求が成功した場合、Irp-IoStatus.Status> はSTATUS_SUCCESSに設定されます。
それ以外の場合は、NTSTATUS コードとして適切なエラー条件の状態。
詳細については、「 NTSTATUS 値」を参照してください。
注釈
この IOCTL を使用する場合は、次のアクションが必要です。
- この IOCTL が、以前に "Pubs\.." で開かれないハンドルで送信される場合。ファイル名を指定すると、ドライバーはSTATUS_INVALID_DEVICE_STATEで完了する必要があります。
- メッセージ データは書き込み 1 回です。 この IOCTL が 1 回成功した場合、同じハンドルで受信した後続のIOCTL_NFP_SET_PAYLOADは、STATUS_INVALID_DEVICE_STATEで完了する必要があります。
- IOCTL に出力バッファーが含まれている場合、ドライバーは、STATUS_INVALID_PARAMETERを使用して IOCTL を完了する必要があります。
- 入力バッファーがドライバーの最大メッセージ サイズを超える場合、ドライバーは、STATUS_INVALID_BUFFER_SIZEを使用して IOCTL を完了する必要があります。
- この IOCTL が成功した後、ハンドルが閉じられる前にいずれかのデバイスが近接状態になった場合、メッセージ データ (その種類と共に) は、近接デバイスに 1 回だけ送信する必要があります。
- ハンドルが閉じられる前に同じ (または異なる) デバイスが再び近接状態になった場合、メッセージをもう一度送信する必要があります。
- この IOCTL が正常に完了したときにデバイスが現在近接している場合は、メッセージ データ (その種類と共に) を近接デバイスに (1 回だけ) 送信する必要があります。 これは、ハンドルが直ちに閉じられた場合でも適用されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 |
| Header | nfpdev.h |