OID_GEN_SUPPORTED_GUIDS
쿼리로 OID_GEN_SUPPORTED_GUIDS OID는 미니포트 드라이버에 NDIS_GUID 형식의 구조 배열을 반환하도록 요청합니다.
버전 정보
Windows Vista 이상 버전의 Windows
지원됩니다.
NDIS 6.0 이상 미니포트 드라이버
선택 사항입니다.
설명
배열의 각 구조체는 사용자 지정 GUID(전역적으로 고유한 식별자)를 사용자 지정 OID 또는 미니포트 드라이버가 NdisMIndicateStatusEx 함수를 통해 보내는 NDIS_STATUS 매핑하도록 지정합니다.
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를 지정합니다.
Oid
Guid가 매핑할 사용자 지정 OID를 지정합니다.
상태
Guid가 매핑되는 NDIS_STATUS 지정합니다.
크기
미니포트 드라이버에서 반환하는 배열의 각 데이터 항목 크기(바이트)를 지정합니다. fNDIS_GUID_ANSI_STRING 또는 fNDIS_GUID_NDIS_STRING 플래그가 설정된 경우 크기 는 -1로 설정됩니다. 그렇지 않으면 Size 는 GUID가 나타내는 데이터 항목의 크기(바이트)를 지정합니다. 이 멤버는 fNDIS_GUID_ARRAY 플래그가 설정된 경우에만 지정됩니다.
플래그
다음 플래그는 OR 연산자가 결합하여 GUID가 OID 또는 NDIS_STATUS 문자열에 매핑되는지 여부를 나타내고 GUID에 제공되는 데이터 형식을 나타낼 수 있습니다.
fNDIS_GUID_TO_OID
NDIS_GUID 구조체가 GUID를 OID에 매핑한다는 것을 나타냅니다.
fNDIS_GUID_TO_STATUS
NDIS_GUID 구조체가 GUID를 NDIS_STATUS 문자열에 매핑한다는 것을 나타냅니다.
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 연산자를 사용하여 결합할 수 있습니다.
다음 예제에서 NDIS_GUID 구조체는 GUID를 OID_802_3_MULTICAST_LIST 매핑합니다.
NDIS_GUID NdisGuid = {{0x44795701, 0xa61b, 0x11d0, 0x8d, 0xd4,
0x00, 0xc0, 0x4f, 0xc3,
0x35, 0x8c},
OID_802_3_MULTICAST_LIST,
6,
fNDIS_GUID_TO_OID | fNDIS_GUID_ARRAY};
GUID는 WMI(Windows Management Instrumentation)에서 정보를 가져오거나 설정하는 데 사용하는 식별자입니다. NDIS는 WMI에서 보낸 GUID를 NDIS 드라이버로 가로채 GUID를 OID에 매핑하고 OID를 드라이버에 보냅니다. 드라이버는 데이터 항목을 NDIS로 반환한 다음, 데이터를 WMI로 반환합니다.
또한 NDIS는 NIC 상태 변경 내용을 WMI에서 인식하는 GUID로 변환합니다. 미니포트 드라이버가 NdisMIndicateStatusEx 함수를 사용하여 NIC 상태 변경 사항을 보고하면 NDIS는 미니포트 드라이버가 나타내는 NDIS_STATUS NDIS가 WMI에 보내는 GUID로 변환합니다.
미니포트 드라이버가 세관 GUID를 지원하는 경우 OID_GEN_SUPPORTED_GUIDS 지원해야 합니다. 이 OID는 사용자 지정 GUID를 사용자 지정 OID 또는 NDIS_STATUS 문자열에 매핑하는 NDIS로 돌아갑니다. OID_GEN_SUPPORTED_GUIDS 사용하여 미니포트 드라이버를 쿼리한 후 NDIS는 미니포트 드라이버의 사용자 지정 GUID를 WMI에 등록합니다.
요구 사항
헤더 |
Ntddndis.h(Ndis.h 포함) |