NDIS_GUID 구조체 채우기

NDIS_GUID 구조체는 다음과 같이 정의됩니다.

typedef struct _NDIS_GUID {
  GUID  Guid;
  union {
    NDIS_OID  Oid;
    NDIS_STATUS  Status;
  };
  ULONG  Size;
  ULONG  Flags;
} NDIS_GUID, *PNDIS_GUID;

구조체의 Guid 멤버에 대한 GUID를 가져오려면 Uuidgen.exe 애플리케이션을 실행할 수 있습니다. 이 애플리케이션에 대한 자세한 내용은 인터페이스 UUID 생성을 참조하세요.

Oid 또는 Status 멤버는 OID 코드인 ULONG입니다. NDIS 6.0은 사용자 지정 상태 표시를 WMI GUID에 매핑하지 않습니다.

NDIS_GUID 구조체가 데이터 항목 배열을 반환하는 OID를 매핑하는 경우 Size 멤버는 배열에 있는 각 데이터 항목의 크기(바이트)를 지정합니다. 데이터가 배열이 아닌 경우 Size 멤버는 데이터의 크기를 지정합니다. 데이터 항목의 크기가 가변적이거나 OID가 데이터를 반환하지 않는 경우 Size 멤버는 -1이어야 합니다.

Flags 멤버에 대한 다음 값의 비트 OR은 GUID와 연결된 데이터 형식을 나타냅니다.

fNDIS_GUID_TO_OID
이 플래그가 설정되면 NDIS_GUID 구조체는 GUID를 OID에 매핑합니다.

fNDIS_GUID_TO_STATUS
NDIS용으로 예약되었습니다. 미니포트 드라이버는 이 플래그를 사용하면 안 됩니다.

fNDIS_GUID_ANSI_STRING
이 플래그를 설정하면 GUID에 대해 null로 종료된 ANSI 문자열이 제공됩니다.

fNDIS_GUID_UNICODE_STRING
이 플래그를 설정하면 GUID에 유니코드 문자열이 제공됩니다.

fNDIS_GUID_ARRAY
이 플래그를 설정하면 GUID에 대한 데이터 항목 배열이 제공됩니다. 지정한 크기 값은 배열에 있는 각 데이터 항목의 길이를 나타냅니다.

fNDIS_GUID_ALLOW_READ
이 플래그가 설정되면 모든 사용자가 이 GUID를 사용하여 정보를 가져올 수 있습니다.

fNDIS_GUID_ALLOW_WRITE
이 플래그가 설정되면 모든 사용자가 이 GUID를 사용하여 정보를 설정할 수 있습니다.

참고 기본적으로 미니포트 드라이버가 제공하는 사용자 지정 WMI GUID는 관리자 권한이 있는 사용자만 액세스할 수 있습니다. 미니포트 드라이버가 해당 GUID에 대한 읽기 또는 쓰기 작업을 지원하는 경우 관리자 권한이 있는 사용자는 항상 사용자 지정 GUID를 읽거나 쓸 수 있습니다. 모든 사용자가 사용자 지정 GUID에 액세스할 수 있도록 fNDIS_GUID_ALLOW_READ 및 fNDIS_GUID_ALLOW_WRITE 플래그를 설정할 수 있습니다.

드라이버가 등록하는 모든 사용자 지정 GUID의 경우 드라이버는 fNDIS_GUID_TO_OID 설정해야 합니다. 미니포트 드라이버는 fNDIS_GUID_TO_STATUS 설정해서는 안 됩니다. 다른 모든 플래그는 비트 OR 연산을 사용하여 결합할 수 있습니다.