IOCTL_STORAGE_BOOT_PARTITION_GET_INFO IOCTL (winioctl.h)

Ruft Startpartitionsinformationen von einem Speichercontroller oder Datenträger ab, indem ein GetLogPage-Befehl für die Startpartitionsprotokollseite (NVME_LOG_PAGE_BOOT_PARTITION) ausgestellt wird.

Rufen Sie zum Ausführen dieses Vorgangs die DeviceIoControl-Funktion mit den folgenden Parametern auf.

BOOL DeviceIoControl(
    HANDLE hDevice,                   // handle to device
    IOCTL_STORAGE_BOOT_PARTITION_GET_INFO,  // dwIoControlCode
    LPVOID lpInBuffer,                // input buffer
    DWORD nInBufferSize,              // size of input buffer
    LPVOID lpOutBuffer,               // output buffer
    DWORD nOutBufferSize,             // size of output buffer
    LPDWORD lpBytesReturned,          // number of bytes returned
    LPOVERLAPPED lpOverlapped         // OVERLAPPED structure
);

Eingabepuffer

Ein Zeiger auf eine STORAGE_HW_BOOT_PARTITION_INFO Struktur. Legen Sie nInBufferSize auf sizeof(STORAGE_HW_BOOT_PARTITION_INFO).

Eingabepufferlänge

Die Größe des Eingabepuffers in Byte.

Ausgabepuffer

Ein Zeiger auf eine STORAGE_HW_BOOT_PARTITION_INFO Struktur, die die Startpartitionsinformationen empfängt. Legen Sie nOutBufferSize auf sizeof(STORAGE_HW_BOOT_PARTITION_INFO).

Länge des Ausgabepuffers

Die Größe des Ausgabepuffers in Byte.

Bemerkungen

Diese IOCTL wird verwendet, um Startpartitionsinformationen von NVMe-Speichergeräten abzufragen, die Startpartitionen unterstützen. Der Controller gibt einen GetLogPage-Befehl aus, der die Startpartitionsprotokollseite (NVME_LOG_PAGE_BOOT_PARTITION) anfordert, um diese Informationen abzurufen.

Der Aufrufer muss über Administratorrechte verfügen, um dieses IOCTL ausstellen zu können.

Anforderungen

Siehe auch

IOCTL_STORAGE_BOOT_PARTITION_ACTIVATE IOCTL, IOCTL_STORAGE_BOOT_PARTITION_DOWNLOAD IOCTL