IOCTL_SFFDISK_DEVICE_PASSWORD IOCTL (sffdisk.h)
ユーザー モード アプリケーションでは、この IOCTL を使用して、カードのパスワードの設定、カードのリセット、カードのロックとロック解除などの基本的な操作を Secure Digital (SD) カードで実行します。 このコマンドの説明については、Secure Digital I/O (SDIO) 仕様を参照してください。
この操作を実行するには、次のパラメーターを使用して、DeviceIoControl 関数 (Microsoft Windows SDK ドキュメントで説明) を呼び出します。
bRet = DeviceIoControl (
(HANDLE) hDevice,
(DWORD) dwIoControlCode,
(PUCHAR) lpInBuffer,
(DWORD) nInBufferSize,
(PUCHAR) lpOutBuffer,
(DWORD) nOutBufferSize,
(LPDWORD) lpBytesReturned,
(LPOVERLAPPED) lpOverlapped
);
パラメーター
- hDeviceの
- SD スタック内のボリュームへのハンドル。
- dwIoControlCodeを する
- 操作の制御コード。 この値は、実行する特定の操作と、実行するデバイスの種類を識別します。 この操作にはIOCTL_SFFDISK_DEVICE_PASSWORDを使用します。
- lpInBufferを する
- 入力バッファーへのポインター。 呼び出し元は、SFFDISK_DEVICE_PASSWORD_DATA 構造体を初期化し、バッファーの先頭に格納する必要があります。 SFFDISK_DEVICE_PASSWORD_DATA構造体の直後に、呼び出し元は、古いパスワードと新しいパスワードの NULL で終わる文字列を渡す必要があります。 現在の (古い) パスワードが最初で、その直後に新しいパスワードが続きます。
- nInBufferSize
- lpInBuffer パラメーターが指す入力バッファーのサイズ (バイト単位) を示します。 入力バッファーのサイズは、sizeof(SFFDISK_DEVICE_PASSWORD_DATA) の合計と、それに続くパスワード情報のサイズ (バイト単位) である必要があります。
- lpOutBufferを する
- 操作の結果を含む出力バッファーへのポインター。 操作が失敗し、GetLastError STATUS_BUFFER_TOO_SMALLエラー コードが返 場合、出力バッファーは結果データを保持するのに十分な大きさではありません。
- nOutBufferSizeを する
- lpOutBuffer パラメーターが指す出力バッファーのサイズ (バイト単位) を格納します。
- lpBytesReturned
-
lpOutBuffer が指すバッファーに格納されている結果データのサイズ (バイト単位) を受け取る変数へのポインター。
出力バッファーが小さすぎて戻りデータを保持できない場合は、出力時に 0 の値が含まれます。呼び出しは失敗し、GetLastError はエラー コード ERROR_INSUFFICIENT_BUFFERを返します。 大文字と小文字を区別します。
lpOverlapped NULL (オーバーラップされていない I/O) 場合、呼び出し元は、入力時に lpBytesReturned パラメーターNULL を割り当てることができません。 lpOverlapped NULL (重複 I/O) しない場合、呼び出し元は、NULL を lpBytesReturned パラメーターに割り当てることができます。
これが重複する操作の場合は、GetOverlappedResult 関数を呼び出すことによって返されるバイト数を取得できます。 hDevice I/O 完了ポートに関連付けられている場合は、GetQueuedCompletionStatus 関数を呼び出すことによって返されるバイト数を取得できます。 GetOverlappedResult および GetQueuedCompletionStatus 関数 の説明については、Windows SDK のドキュメントを参照してください。
- lpOverlappedを する
-
Windows SDK ドキュメントで説明されているように、OVERLAPPED 構造体へのポインター。
呼び出し元が FILE_FLAG_OVERLAPPED フラグを使用してデバイスを開いた場合、lpOverlapped は有効な OVERLAPPED 構造体を指している必要があります。 この場合、システムは、重複 非同期操作として DeviceIoControl を実行します。 呼び出し元がFILE_FLAG_OVERLAPPED フラグを使用してデバイスを開き、lpOverlapped が NULL 場合、関数は予期しない方法で失敗します。
呼び出し元がFILE_FLAG_OVERLAPPED フラグを指定せずにデバイスを開いた場合、システムは lpOverlapped 値を無視し、DeviceIoControl 関数は操作が完了するまで、またはエラーが発生するまで戻りません。
操作が成功すると、DeviceIoControl 0 以外の値が返されます。
操作が失敗した場合、DeviceIoControl は 0 を返します。 拡張エラー情報を取得するには、GetLastError 呼び出します。
要件 | 価値 |
---|---|
ヘッダー | sffdisk.h (Sffdisk.h を含む) |