NVME_COMPLETION_ENTRY 구조체(nvme.h)

완료 큐의 크기가 16바이트인 항목을 지정합니다.

구문

typedef struct {
  ULONG DW0;
  ULONG DW1;
  union {
    struct {
      USHORT SQHD;
      USHORT SQID;
    } DUMMYSTRUCTNAME;
    ULONG AsUlong;
  } DW2;
  union {
    struct {
      USHORT              CID;
      NVME_COMMAND_STATUS Status;
    } DUMMYSTRUCTNAME;
    ULONG AsUlong;
  } DW3;
} NVME_COMPLETION_ENTRY, *PNVME_COMPLETION_ENTRY;

멤버

DW0

Dword 0의 콘텐츠에는 명령 관련 정보가 포함되어 있습니다.

명령이 Dword 0을 사용하는 경우 이 Dword의 정의는 연결된 명령 정의 내에 포함됩니다. 명령이 Dword 0을 사용하지 않는 경우 이 필드는 예약됩니다.

DW1

DW2

Dword 2의 정보를 포함하는 공용 구조체입니다.

DW2.DUMMYSTRUCTNAME

DW2.DUMMYSTRUCTNAME.SQHD

SQ 식별자(SQID) 필드에 표시된 제출 큐의 현재 제출 큐 헤드 포인터를 나타냅니다. 이는 사용된 제출 큐 항목을 호스트에 나타내는 데 사용되며 새 항목에 다시 사용될 수 있습니다.

참고

반환되는 값은 완료 큐 항목을 만들 때 제출 큐 헤드 포인터의 값입니다. 호스트 소프트웨어가 완료 큐 항목을 사용할 때까지 컨트롤러에 표시된 값을 초과하는 고급 SQ 헤드 포인터가 있을 수 있습니다.

DW2.DUMMYSTRUCTNAME.SQID

연결된 명령이 실행된 제출 큐를 지정합니다. SQID 필드는 호스트 소프트웨어에서 CID(명령 식별자)와 함께 사용하여 둘 이상의 제출 큐가 단일 완료 큐를 공유하는 경우 완료된 명령을 고유하게 결정합니다.

DW2.AsUlong

DW3

Dword 3의 정보를 포함하는 공용 구조체입니다.

DW3.DUMMYSTRUCTNAME

DW3.DUMMYSTRUCTNAME.CID

완료 중인 명령의 식별자를 나타냅니다.

이 식별자는 명령이 제출 큐에 제출될 때 호스트 소프트웨어에 의해 할당됩니다. SQ 식별자 SQID 와 명령 식별자 CID 의 조합은 완료되는 명령을 고유하게 식별합니다. 한 번에 최대 미해결 요청 수는 64K입니다.

DW3.DUMMYSTRUCTNAME.Status

완료되는 명령에 대한 상태 나타내는 NVME_COMMAND_STATUS 구조체입니다.

이 필드의 0h 값은 치명적이거나 치명적이 아닌 오류 조건이 없는 성공적인 명령 완료를 나타냅니다. 달리 명시되지 않는 한 여러 가지 이유로 명령이 성공적으로 완료되지 않으면 공급업체에서 반환된 특정 상태 코드를 선택합니다.

DW3.AsUlong

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10
머리글	nvme.h