NDIS_RESTART_ATTRIBUTES 구조체(ndis.h)

아티클
02/16/2022
읽는 데 3분 걸림

NDIS_RESTART_ATTRIBUTES 구조는 다시 시작 특성의 연결된 목록에서 특성 항목을 식별합니다.

구문

typedef struct _NDIS_RESTART_ATTRIBUTES {
  PNDIS_RESTART_ATTRIBUTES Next;
  NDIS_OID                 Oid;
  ULONG                    DataLength;
  UCHAR                    Data[1];
} NDIS_RESTART_ATTRIBUTES, *PNDIS_RESTART_ATTRIBUTES;

구성원

Next

연결된 특성 목록에서 다음 다시 시작 특성 집합에 액세스하는 데 사용할 수 있는 NDIS_RESTART_ATTRIBUTES 구조체에 대한 포인터입니다. 추가 특성이 없으면 이 멤버는 NULL입니다.

Oid

데이터 멤버에 있는 정보에 대한 NDIS 개체 식별자입니다. 예를 들어 Oid 가 OID_GEN_MINIPORT_RESTART_ATTRIBUTES 경우 데이터 멤버에는 NDIS_RESTART_GENERAL_ATTRIBUTES 구조가 포함됩니다.

DataLength

데이터 멤버에 저장된 정보의 길이(바이트)입니다.

Data

Oid 멤버에 지정된 OID와 연결된 정보를 포함하는 버퍼입니다.

설명

NDIS가 드라이버 스택을 다시 시작하면 NDIS는 미니포트, 필터 및 프로토콜 드라이버에 연결된 다시 시작 특성 목록에 대한 포인터를 전달합니다.

미니포트 드라이버의 MiniportRestart 함수를 호출할 때 NDIS는 NDIS_MINIPORT_RESTART_PARAMETERS 구조체의 RestartAttributes 멤버에 있는 미니포트 드라이버에 NDIS_RESTART_ATTRIBUTES 구조체에 대한 포인터를 전달합니다.

필터 드라이버의 FilterRestart 함수를 호출하면 NDIS는 NDIS_FILTER_RESTART_PARAMETERS 구조체의 RestartAttributes 멤버에 있는 필터 드라이버에 NDIS_RESTART_ATTRIBUTES 구조체에 대한 포인터를 전달합니다.

프로토콜 바인딩을 다시 시작하면 NDIS는 NDIS_PROTOCOL_RESTART_PARAMETERS 구조체의 RestartAttributes 멤버에서 NDIS_RESTART_ATTRIBUTES 구조체에 대한 포인터를 제공합니다. 프로토콜 바인딩을 다시 시작하기 위해 NDIS는 프로토콜 드라이버의 ProtocolNetPnPEvent 함수를 호출합니다. NDIS 가 ProtocolNetPnPEvent 에 전달하는 NET_PNP_EVENT_NOTIFICATION 구조체의 NetPnPEvent 멤버에는 NET_PNP_EVENT 구조가 포함됩니다. NET_PNP_EVENT 구조체는 NetEvent 멤버의 NetEventRestart와 Buffer 멤버의 NDIS_PROTOCOL_RESTART_PARAMETERS 구조체에 대한 포인터를 지정합니다.

NDIS가 NDIS 드라이버에 전달하는 다시 시작 특성 포인터가 NULL인 경우 드라이버는 해당 특성을 전파하면 드라이버 스택이 변경됩니다. 이 경우 드라이버는 특성 변경 내용을 수정하거나 보고해서는 안 됩니다.

다시 시작 특성 포인터가 NULL이 아닌 경우 NDIS_RESTART_ATTRIBUTES 구조체의 연결된 목록에는 NDIS_RESTART_GENERAL_ATTRIBUTES 구조체가 포함된 항목이 하나 이상 있습니다. 나머지 항목(있는 경우)에는 미디어별 특성이 포함됩니다.