NdisMCmRequestComplete
VOID
NdisMCmRequestComplete(
IN NDIS_STATUS Status,
IN NDIS_HANDLE NdisAfHandle,
IN NDIS_HANDLE NdisVcHandle OPTIONAL,
IN NDIS_HANDLE NdisPartyHandle OPTIONAL,
IN PNDIS_REQUEST NdisRequest
);
|
NdisMCmRequestComplete함수는 MCM드라이버의 ProtocolCoRequest함수가 이전에 NDIS_STATUS_PENDING을 리턴한것에대해 클라이언트의 OID_GEN_CO_XXX의 최종 상태를 리턴한다.
매개변수
- Status
- 요청된 연산의 최종 상태를 지정한다. NDIS_STATUS_SUCCESS혹은 NDIS_STATUS_PENDING을 제외한 드라이버 의존 NDIS_STATUS_XXX.
- NdisAfHandle
- AF핸들을 지정한다. 이것은 이 요청을 만든 클라이언트를 절대적으로 확인한다. MCM드라이버는 처음에 ProtocolCmOpenAf함수의 입력 파라미터로써 이 핸들을 얻고 ProtocolCoRequest함수로 넘겨진 ProtocolAfContext에의해 설명된 AF당 상태로부터 더 최근에 얻는다.
- NdisVcHandle
- 만약 요청이 전적으로 VC지정이 아니라면,VC핸들혹은 NULL을 지정한다. VC지정 요청에대해, MCM드라이버는 ProtocolCoRequest함수로 넘겨진 ProtocolVcContext에의해 설명된 VC당 상태로부터 이 핸들을 얻는다.
- NdisPartyHandle
- 만약 요청이 전적으로 파티-지정이 아니라면, 파티 핸들혹은 NULL을 지정한다. 파티 지정 요청에대해, MCM드라이버는 ProtocolCoRequest함수에게 넘겨진 ProtocolPartyContext에의해 설명된 파티당 상태로부터 이 핸들을 얻는다.
- NdisRequest
- NDIS_REQUEST구조체로서 구조화된 버퍼의 포인터, 이것은 NdisCoRequest함수를 호출하는 클라이언트가 제공한다.
주석
NdisMCmRequestComplete함수에대한 호출은 주어진 핸들과 NdisRequest포이터로 NdisCoRequest함수를 처음에 호출하는 클라이언트의 ProtocolCoRequestComplete함수에대한 호출을 야기한다.
NDIS_STATUS_PENDING을 리턴하는것에대한 클라이언트 지정 요청에대한 응답으로, 그런 MCM드라이버는 순차적으로 각각의 그런 요청이 각각 MCM드라이버의 ProtocolCoRequest함수 혹은 MiniportCoRequest함수에 의존하여 NdisMCmRequestComplete 혹은 NdisMCoRequestComplete함수를 호출해야만 한다.
MCM드라이버의 MiniportQueryInformation 와MiniportSetInformation함수는 일반적으로 초기화 동안에 닉 미니포트들에대해 행해지는 OID_GEN_XXX쿼리와 같은 NdisRequest함수에게 넘겨준 클라이언트의 요청들을 다룬다. 그렇지 않으면, 바인딩된 프로토콜이 NdisRequest함수를 호출할때, NDIS는 MCM드라이버의 MiniportCoRequest함수를 호출한다.
NdisMCmRequest, NdisCoRequest, 와 NdisRequest함수의 사용에대한 정의된 OIDs설정에대한 더많은 정보에대해서는 이 메뉴얼의 Part 2를 보라.
NdisMCmRequestComplete함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작한다.
|