NdisMCmRequest

NDIS_STATUS 

  NdisMCmRequest(

    IN NDIS_HANDLE  NdisAfHandle ,

    IN NDIS_HANDLE  NdisVcHandle  OPTIONAL,

    IN NDIS_HANDLE  NdisPartyHandle  OPTIONAL,

    IN OUT PNDIS_REQUEST  NdisRequest

    );

NdisMCmRequest함수는 MCM드라이버로부터 OID_GEN_CO_XXX요청을 클라이언트에게 행한다.

매개변수

NdisAfHandle
오픈 어드레스 패밀리를 확인하는 핸들을 지정하고 클라이언트에게 이 요청이 다이렉트 됐다는것을 알린다. MCM드라이버는 처음에 ProtocolCmOpenAf함수에대한 입력 파라미터로써 이 핸들을 얻는다.

NdisVcHandle
만약 요청이 VC지정이라면 혹은 이 파라미터가 NULL이라면, 호출자가 정보를 요청하거나 설정하는것에대한 VC를 확인하는 핸들을 지정한다. 어떤 VC지정 요청에대해, 호출자는 처음에 이핸들을 NdisMCmCreateVc함수로 VC가 만들어졌을때 혹은 ProtocolCoCreateVc함수에대한 입력 파라미터로써 이핸들을 얻는다.

NdisPartyHandle
만약 요청이 파티 지정이거나 혹은 이 파라미터가 NULL이면, 호출자가 정보를 설정하고 요청하는것에대한 멀티포인트VC에대한 파티를 확인하는 핸들을 지정한다. 어떤 파티 지정 요청에대해, MCM드라이버는 처음에 이 핸들을 ProtocolCmAddParty함수에대한 입력 핸들로써 얻는다.

NdisRequest
호출자에의해 설정되는 NDIS_REQUEST타입 구조체로써 포맷된 호출자 할당 상주 버퍼의 포인터.

리턴값

NdisMCmRequest함수가 NDIS_STATUS_PENDING이외의 다른것을 리턴할때, 호출자는 ProtocolCoRequestComplete함수에대한 내부적인 호출을 만들어야한다. 그렇지 않으면, 이 연산이 완료될때, NDIS는 드라이버의 ProtocolCoRequestComplete함수를 호출한다.

주석

NdisMCmRequest함수를 호출하기전에, MCM미니포트는 요청에대한 메로리를 할당하고 NDIS_REQUEST구조체를 초기화 한다. 그런 드라이버는 클라이언트와의 통신때 시스템 정의 OID_GEN_CO_XXX로 NDIS_REQUEST구조체의 Oid멤버를 설정한다.

MCM드라이버는 NdisAfHandle에의해 확인되는 주어진 클라이언트에대한 어드레스의 변화와 같은 연결지향 정보를 얻기위해 NdisMCmRequest함수를 호출할수 있다.

만약 MCM드라이버의 요청이 실제로 VC지정 혹은 파티 지정 이라면, MCM드라이버는 또한 확실한 NdisVcHandle 혹은 NdisPartyHandle를 각각 NdisMCmRequest함수에게 넘긴다.

NdisMCmRequest함수를 사용하느것에대해 정의된 OID_GEN_CO_XXX대한 더 많은 정보는 이 메뉴얼의 Part 2를 보아라.

NdisMCmRequest함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작될수 있다.