IOCTL_SFFDISK_DEVICE_PASSWORD IOCTL (sffdisk.h)
使用者模式應用程式會使用此 IOCTL 在 Secure Digital (SD) 卡上執行基本作業，例如在卡片上設定密碼、重設卡片或鎖定和解除鎖定卡片。 如需此命令的描述，請參閱 安全數位 I/O (SDIO) 規格。
若要執行這項作業，請使用下列參數，呼叫 Microsoft Windows SDK 檔中所述的DeviceIoControl函式) (。
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 所指向之緩衝區中儲存結果數據的位元元組大小變數指標。
如果輸出緩衝區太小而無法保存傳回數據，則會在輸出中包含零的值，呼叫將會失敗， 而 GetLastError 會傳回錯誤碼ERROR_INSUFFICIENT_BUFFER。 萬一。
如果 lpOverlapped 為 NULL (非重疊 I/O) ，呼叫端就無法在輸入上將 NULL 指派給 lpBytesReturned 參數。 如果 lpOverlapped 不是 NULL (重疊的 I/O) ，呼叫端可以將 NULL 指派給 lpBytesReturned 參數。
如果這是重疊的作業，您可以呼叫 GetOverlappedResult 函式來擷取傳回的位元組數目。 如果 hDevice 與 I/O 完成埠相關聯，您可以呼叫 GetQueuedCompletionStatus 函式來取得傳回的位元元組數目。 如需 GetOverlappedResult 和 GetQueuedCompletionStatus 函式的描述，請參閱 Windows SDK 檔。
- lpOverlapped
-
重迭結構的指標，如 Windows SDK 檔中所述。
如果呼叫端以FILE_FLAG_OVERLAPPED旗標開啟裝置， lpOverlapped 必須指向有效的 OVERLAPPED 結構。 在此情況下，系統會以重疊的異步操作方式執行 DeviceIoControl 。 如果呼叫端以FILE_FLAG_OVERLAPPED旗標開啟裝置，而 lpOverlapped 為 NULL，則函式會以無法預測的方式失敗。
如果呼叫端未指定FILE_FLAG_OVERLAPPED旗標，則系統會忽略 lpOverlapped 中的值，且 DeviceIoControl 函式不會在作業完成或發生錯誤之前傳回。
主要程序代碼
狀態區塊
如果作業成功， DeviceIoControl 會傳回非零值。
如果作業失敗， DeviceIoControl 會傳回零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | sffdisk.h (包含 Sffdisk.h) |