NdisAdjustBufferLength
VOID
NdisAdjustBufferLength(
IN PNDIS_BUFFER Buffer,
IN UINT Length
);
|
NdisAdjustBufferLength 함수는 호출자에 의해서 할당되거나 복사된 버퍼 서술자의 길이를 바꾼다.
매개변수
- Buffer
- 이전에 NdisAllocateBuffer나 NdisCopyBuffer에 의해서 할당된 버퍼 서술자를 가리킨다.
- Length
- 버퍼 서술자에 설정될 새로운 길이를 가리킨다.
주석
NdisAdjustBufferLength의 호출자는 호출자에 의해서 할당된 버퍼 서술자에게만 전해줄 수 있다. 다른 드라이버에 의해서 할당된 버퍼 서술자에게는 전해줄 수 없다.
예를 들어, 버스마스터 DMA NIC 드라이버는 그것의 공유 메모리 블럭안에서 리시브 버퍼에 할당된 버퍼 서술자를 가진 이 함수를 서술한다. 그러한 드라이버가 받은 데이타를 인디케이트하기 전에 버퍼 서술자를 만들기 위해 NdisAdjustBufferLength를 호출한다. 그 버퍼 서술자는 NIC의 리시브 버퍼의 사이즈보다 작다면 받은 데이타의 사이즈와 대등한 리시브 인디케이션을 포함할 것이다. 이처럼 조절된 버퍼 서술자를 갖는 리시브 패킷이 소모되어 미니포트로 리턴됬을 때, 드라이버는 리시브 버퍼의 실제 사이즈에 대등한 버퍼 서술자를 만들기 위해 NdisAdjustBufferLength를 다시 호출한다.
버퍼 서술자가 할당됬을 때 NdisAdjustBufferLength로 전해진 길이는 NdisAllocateBuffer나 NdisCopyBuffer로 전해진 길이보다 더 커질 수 없다. NdisAdjustBufferLength의 호출자는 NdisFreeBuffer의 실행으로 버퍼 서술자가 해제되기 전에 원래의 길이로 되돌려놔야한다.
드라이버는 NdisAdjustBufferLength를 호출하기 전에 현재 잡고 있는 어떤 스핀락을 해제해야만한다.
NdisAdjustBufferLength의 호출자는 어떤 IRQL에서도 실행할 수 있다. 하지만 보통 IRQL <= DISPATCH_LEVEL 에서 실행한다.
|