NDIS_GENERIC_OBJECT 구조체(ndis.h)

아티클
02/29/2024

NDIS_GENERIC_OBJECT 구조체는 소프트웨어 구성 요소가 NDIS 핸들을 가져오는 데 사용할 수 있는 제네릭 개체를 정의합니다.

구문

typedef struct _NDIS_GENERIC_OBJECT {
  NDIS_OBJECT_HEADER Header;
  PVOID              Caller;
  PVOID              CallersCaller;
  PDRIVER_OBJECT     DriverObject;
} NDIS_GENERIC_OBJECT, *PNDIS_GENERIC_OBJECT;

멤버

Header

제네릭 개체 구조체( NDIS_GENERIC_OBJECT )에 대한 NDIS_OBJECT_HEADER 구조체입니다. NDIS는 Header가 NDIS_OBJECT_TYPE_GENERIC_OBJECT 지정하는 구조체의 Type 멤버, NDIS_GENERIC_OBJECT_REVISION_1 수정 멤버 및 size 멤버를 sizeof(NDIS_GENERIC_OBJECT)로 설정합니다.

Caller

NDIS용으로 예약되었습니다.

CallersCaller

NDIS용으로 예약되었습니다.

DriverObject

제네릭 개체와 연결된 드라이버 개체입니다. 드라이버 개체가 없는 경우 이 멤버는 NULL입니다. 이는 의 DriverObject 매개 변수에 전달된 값입니다. NdisAllocateGenericObject 함수입니다.

설명

NDIS 핸들이 없는 소프트웨어 구성 요소는 NdisAllocateGenericObject 를 호출하여 제네릭 개체를 만듭니다. 이러한 구성 요소는 NdisAllocateGenericObject 에서 가져온 핸들을 사용하여 NDIS 리소스를 할당합니다.

NdisAllocateGenericObject의 Size 매개 변수는 호출자에 대해 예약할 메모리 양(바이트)을 지정합니다. NdisAllocateGenericObject 는 NDIS_OBJECT_STRUCTURE 멤버 다음에 추가 메모리를 추가합니다.

대부분의 NDIS 드라이버는 핸들을 가져오기 위해 제네릭 개체가 필요하지 않습니다. NDIS 프로토콜, 중간 및 미니포트 드라이버는 초기화 중에 핸들을 가져옵니다.

NdisFreeGenericObject 함수를 사용하여 NdisAllocateGenericObject로 만든 제네릭 개체를 해제합니다.